geoffry304/yii2-widget-timer

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

安装: 17

依赖者: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 2

语言:JavaScript

类型:yii2-extension

v1.4 2018-06-12 14:57 UTC

This package is auto-updated.

Last update: 2024-09-18 02:31:04 UTC


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