# 计时器

它是每秒对设置的时间值进行递减计数的组件。

- 静态 ： 可以在建模时以天，小时，分钟和秒为单位静态设置时间值。
- 动态 ： 在运行时在 value 属性中设置时间（seconds）值。
- 在数据属性中设置倒计时过程的按格式运行和按格式停止的结果值。
- 时间格式， 停止格式在运行和结束时以对应的格式设置为 data
- 另外，计时器组件还提供了简单的水平进度条显示功能。进度颜色的设置将随着倒计时的进行而显示。

  ![fill-color]

  [fill-color]: ../images/timer-fill-color.png

## 属性

- 天
  - number
  - 计时日期配置(0- )
- 时间
  - number
  - 计时时间配置(0-23)
- 分
  - number
  - 计时分配置(0-59)
- 秒
  - number
  - 计时秒配置(0-59)
- 时间格式
  - string
  - format : hh:mm:ss
  - 计时结果表现格式
- 停止格式
  - string
  - format : --:--:--
  - 计时结束后显示的时间格式
- 进度颜色（Progress Color）

  - 类型：字符串，RGB 颜色
  - 描述：倒计时中进度的颜色。

- 数据反映（Data Reflection）

  - 倒计时：在倒计时期间的每一秒，剩余时间都会按照“倒计时格式”或“停止格式”中设置的格式反映在数据中。
  - 圆形：在每个倒计时循环完成后，循环数会反映在数据中。（在此情况下，在倒计时期间数据值保持不变。）

- 重复（Repeat）
  - 描述：选中此选项后，每次倒计时完成后，倒计时会自动重新开始。

## 隐藏属性

- timeout

  - number (seconds)
  - 计时器的 value 属性(秒).
  - 因为是计时器的 value 属性, 可以把数据传递到 value 属性中

    > ex) 在点击事件中选择"set value to target component", 使用 class 传递数据

    ![button]

    > ex) 在数据源的数据共享属性中将数据传递到计时器的 value 中, 使用(key)传递数据

    ![databind]

  [button]: ../images/rect-button.png
  [databind]: ../images/timer-data-bind.png

- countdown

  - readonly： 只读属性
  - number (seconds)
  - 从设置定时器设置值开始，它就将当前值递减计数。

- round
  - 只读
  - 数字
  - 倒计时的回合数
