3.5.2.1.48. 时间组件

在线示例

API 文档

TimeField 是用来显示和输入时间的组件。

gui timeField

组件的 XML 名称: timeField

  • 要创建关联数据的时间组件，应该使用数据容器和 property 属性:

    1. <data>
    2.     <instance id="orderDc" class="com.company.sales.entity.Order" view="_local">
    3.         <loader/>
    4.     </instance>
    5. </data>
    6. <layout>
    7.     <timeField dataContainer="orderDc" property="deliveryTime"/>
    8. </layout>

    如同上面的示例，在界面描述中为实体 Order 定义了数据容器 orderDc ，实体具有 deliveryTime 属性。时间输入组件的 dataContainer 属性包含到数据容器的连接， property 属性 – 设置要显示在时间字段中的实体属性名称。

    关联的实体属性类型应该是 java.util.Date 或 java.sql.Time 类型。

  • 如果该控件不与实体属性相关联（比如没有设置数据容器和属性名称），可以使用 datatype 属性设置数据类型。 TimeField 使用如下数据类型：

    • localTime

    • offsetTime

    • time

  • 时间格式通过 time 数据类型定义，并且在主本地化消息包中通过 timeFormat 键指定。

  • 时间格式也可以通过 timeFormat 属性指定，属性值可以是一个格式化字符串，或者是消息包中的键名(前缀：msg:// )。

  • 无论上面提到的属性如何设置，都可以通过 showSeconds 属性控制是否显示秒。默认情况下，如果时间格式中包含 ss，则显示秒。

    1. <timeField dataContainer="orderDc" property="createTs" showSeconds="true"/>

    gui timeFieldSec

timeField 的属性

align - caption - captionAsHtml - contextHelpText - contextHelpTextHtmlEnabled - css - dataContainer - datasource - datatype - description - descriptionAsHtml - editable - enable - box.expandRatio - height - icon - id - property - required - requiredMessage - showSeconds - stylename - tabIndex - timeFormat - visible - width

timeField 的元素

validator

API

addValueChangeListener - commit - discard - isModified - setContextHelpIconClickHandler