aayaresko / yii2-widget-timer
显示可控制的计时器/秒表的Yii2小部件
v1.1
2016-04-26 12:55 UTC
Requires
- php: >=5.3.0
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
。