时间器是文字组件的一种，支持自定义时间器的图标样式和文本样式，包括图标的大小、颜色、位置以及时间的显示格式等，能够在可视化应用中展示系统的当前时间，帮助您合理控制可视化应用或可视化应用中某个模块的演示时间。本文介绍时间器各配置项的含义。

配置

  • 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置对话框中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索组件配置。
  • 图表尺寸：包括组件的宽度和高度，单位为px。可单击锁定长宽比按键锁定组件的宽高比，等比例修改组件的宽高。再次单击进行解锁，解锁后宽高比不受限制。
  • 图表位置：包括组件的横坐标和纵坐标，单位为px。横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
  • 旋转角度：以组件的中心为中心点，进行旋转，单位为度（°）。
    • 手动输入角度值，控制组件的旋转角度。
    • 拖动圆圈旋转控制图标图标内的黑点，控制组件的旋转角度。
    • 单击左右翻转图标图标，控制组件左右翻转样式。
    • 单击上下翻转图标图标，控制组件上下翻转样式。
  • 透明度：取值范围为0~1。为0时，图表隐藏；为1时，图表全部显示。默认为1。
  • 图标样式：时间器中图标的样式。时间器的图标样式
    参数 说明
    大小 图标的大小，若不需要图标则设置为0。
    颜色 图标的颜色，请参见颜色选择器说明进行修改。
    边距 图标与时间器文本之间的距离。
  • 时间器
    参数 说明
    文本样式 设置时间器文本的字体、字号、字体颜色和字体粗细。
    格式化 设置时间器文本的显示格式。默认为yyyy-MM-dd HH:mm:ss，表示“年月日时分秒”的时间格式，为24小时制的格式。如果为hh:mm:ss，表示12小时制的格式。
    间隔时间 设置组件时间变化的间隔时间，单位为ms。例如设置为10000ms，那么组件的时间每隔10s变化一次。
    停住时间 时间器中的时间是不断变化的，此配置项可以设置时间器的时间在什么时候停住，不再发生变化。需要与格式化配置项中配置的时间格式保持一致。

    例如设置停住时间为2019-05-27 11:52:00，那么当时间器的时间变化到2019-05-27 11:52:00时，时间将停住，不再变化。

    停住显示时间 设置时间器的时间停住后，显示的时间，只有配置了停住时间后才会生效。需要与格式化配置项中配置的时间格式保持一致。

    例如设置停住时间为2019-05-27 11:52:00，停住显示时间为2019-05-28 12:00:00，那么当时间器的时间变化到2019-05-27 11:52:00时，时间将停住，且显示为2019-05-28 12:00:00。

  • 回调配置
    参数 说明
    定时回调设置 单击眼睛图标图标控制定时回调设置的显隐。

    回调抛出间隔：每隔多久抛出一次回调值，单位为ms。

    定点回调设置 单击眼睛图标图标控制定点回调设置的显隐。

    定点抛出时间：回调值抛出的时间点，支持表示日期的字符串值。

数据

此组件不需要配置数据，默认读取系统当前时间。

交互

交互事件 说明
当时间变化时 选中启用，开启组件交互功能。在当前时间发生变化时，系统会自动抛出回调值，默认抛出time（当前时间）字段值。详细配置请参见组件回调ID配置。
注意 在当前时间发生变化时，系统会隔一段时间再抛出回调值，此时间可在配置面板的 回调配置 > 回调抛出间隔中设置，默认为3000ms。
当时间到设置时间时 选中启用，开启组件交互功能。当时间到设置的时间时，系统会自动抛出回调值，默认抛出time（当前时间）字段值。详细配置请参见组件回调ID配置。

蓝图编辑器交互配置

  1. 在画布编辑器页面，右键单击组件，选择导出到蓝图编辑器。
  2. 单击页面左上角的蓝图图标图标。
  3. 在蓝图编辑器配置页面，单击导入节点栏内的时间器组件，在画布中可以看到如下图所示的时间器的蓝图编辑器配置参数。时间器蓝图参数
    • 事件
      事件 说明
      当时间变化时 当时间变化时抛出的事件，同时抛出当前时间对应的数据项。
      当时间到设置时间时 当时间到设置时间时抛出的事件，同时抛出当前时间对应的数据项。
    • 动作
      动作 说明
      更新组件配置 动态更新组件的样式配置。需要先在组件的配置面板中，单击复制配置到剪贴板，获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。
      显示 显示组件，不需要参数。
      隐藏 隐藏组件，不需要参数。
      切换显隐状态 切换组件显示或者隐藏。
      移动 将组件移动到指定位置。参考数据示例如下。
          {
      // 移动方式。绝对定位：to，相对定位：by。默认值：to。
        "positionType": "to",
      // 指定位置。x坐标，y坐标。
      "attr": {
        "x": 0,
        "y": 0
      },
      // 动画方式。
      "animation": {
        "enable": false,
        // 动画延时。
        "animationDuration": 1000,
        // 动画曲线。可选值为：linear|easeInOutQuad|easeInOutExpo。
        "animationEasing": "linear"
      }
    }