DatePicker 日期选择

在线示例

DatePicker - 日期组件 是用来显示和选择日期的组件。跟 DateField 里面的下拉式日期选择器是有一样的外观。

date picker

组件的 XML 名称：datePicker。

基本用法

DatePicker 与 DateField 的工作机制一样，除了此组件右侧没有 TimeField，配置也少一些。

属性

精度

resolution 属性可以定义日期精度。支持下列值：

  • DAY - 默认值，精确到天。

  • MONTH

  • YEAR

<datePicker resolution="MONTH"/>

rangeStart 和 rangeEnd

可以通过这两个属性来定义可选的日期范围。一旦日期范围设定了，其他在范围之外的日期都会变成不可选状态。XML 中用 “yyyy-MM-dd” 格式设置范围，或通过对应的 setter 在 Java 中设置。

<datePicker rangeStart="2021-04-05"
            rangeEnd="2021-04-11"/>

事件和处理器

如需使用 Jmix Studio 生成处理器的桩代码，需要在界面 XML 描述或者 Jmix UI 层级结构面板选中该组件，然后用 Jmix UI 组件面板的 Handlers 标签页生成。

或者可以使用界面控制器顶部面板的 Generate Handler 按钮。

ContextHelpIconClickHandler

参阅 ContextHelpIconClickHandler。

Validator

参阅 Validator。

ValueChangeEvent

参阅 ValueChangeEvent。

DatePicker XML 属性

可以使用 Studio 界面设计器的 Jmix UI 组件面板查看和编辑组件的属性。

align - box.expandRatio - buffered - caption - captionAsHtml - colspan - contextHelpText - contextHelpTextHtmlEnabled - css - dataContainer - datatype - description - descriptionAsHtml - editable - enable - height - htmlSanitizerEnabled - icon - id - property - rangeEnd - rangeStart - resolution responsive - rowspan - stylename - tabIndex - visible - width