geoffry304 / yii2-widget-timer
Yii2 小部件,用于显示可控制的计时器/秒表
v1.4
2018-06-12 14:57 UTC
Requires
- php: >=5.3.0
README
基于yii2的简单计时器小部件
基于jQuery插件的计时器小部件。
显示计时器开始后经过的时间,格式为 HH:MM:SS
- HH - 经过的时数;
- ММ - 经过的分钟数;
- CC - 经过的秒数;它可以自动运行(页面加载后)或手动运行。可以停止和重置计时器。
安装
安装此扩展的首选方式是通过 composer。检查composer.json以了解此扩展的要求和依赖关系。
要安装,请运行以下命令之一:
$ php composer.phar require geoffry304/yii2-widget-timer "*"
或添加
"geoffry304/yii2-widget-timer": "*"
到您的 composer.json 文件的 require 部分中。
使用方法
上传所有必要的组件并准备小部件
use geoffry304\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。