aayaresko/yii2-widget-timer

显示可控制的计时器/秒表的Yii2小部件

安装次数: 9,042

依赖项: 0

建议者: 0

安全性: 0

星标: 1

关注者: 2

分支: 2

开放问题: 0

语言:JavaScript

类型:yii2-extension

v1.1 2016-04-26 12:55 UTC

This package is not auto-updated.

Last update: 2024-09-14 16:18:48 UTC


README

基于yii2应用的简单计时器小部件

基于jQuery插件的计时器小部件。

以HH:MM:SS格式显示计时器开始后经过的时间

  • HH - 经过的小时;
  • MM - 经过的分钟;
  • CC - 经过的秒;它可以自动运行(页面加载后)或手动运行。可以停止和重置计时器。

安装

安装此扩展的首选方式是通过composer。请检查composer.json以获取此扩展的需求和依赖关系。

要安装,请执行以下操作之一:

$ php composer.phar require aayaresko/yii2-widget-timer "*"

或添加以下内容到您的composer.json文件的require部分:

"aayaresko/yii2-widget-timer": "*"

使用

用法

上传所有必要的组件并准备小部件

use aayaresko\timer\Timer
Timer::widget([
    'options' => [
        'container' => '.timer',
        'autoStart' => true,
    ]
])

在HTML中的任何位置添加一个带有类名'timer'的html标签。此标签的内容将被小部件替换。

<div class="timer"></div>

插件的运行副本将在全局范围内,可以通过$.fn.timer.worker进行控制。初始化后计时器将自动运行(如果指定了'autoStart'参数)并分配给具有类'timer'的容器('container'属性)。

运行计时器

    $.fn.timer.worker.go();

插件配置

  • container - 计时器容器元素的html选择器(默认 - '.timer');
  • autoStart - 初始化后是否自动开始计时器(默认 - true);
  • hours - 从此值开始计算小时数(默认 '00');
  • minutes - 从此值开始计算分钟数(默认 '00');
  • seconds - 从此值开始计算秒数(默认 '00');
  • animate - 启动时是否运行动画(闪烁);
  • animationSpeed - 动画速度;
  • animationTimes - 闪烁次数;

插件控制

  • init(value) - 初始化计时器,仅显示计时器(value == false)或自动运行计时器(value == true),如果计时器已运行,则此操作将停止计时器并重置所有计数器(小时、分钟、秒);
  • go() - 运行计时器;
  • stop(value) - 停止计时器并保持计数器(小时、分钟、秒)(value == false)或重置它们(value == true);
  • flush() - 重置计时器计数器(小时、分钟、秒);
  • timeAsString() - 返回当前时间值作为字符串。

许可证

yii2-widget-timer在BSD 3-Clause许可证下发布。有关详细信息,请参阅附带的LICENSE.md