一个用于选择日期的组件。
若传递了 date
属性,就必须确保自己对她的控制。
当日期选择结束后,回调函数 onChange
将会被调用
属性 show
和 auto
使得组件的使用更加灵活。 show
可以直接控制日期选择框的打开或关闭。 autoOk
代表当日期被成功选择后,是否自动关闭选择框。
而除了默认的格式化之外,提供了一个 format
函数,返回一个格式化后的字符串。
withClear
属性用于清空已选择的日期。
自动模式,date
为null
Name | Type | Parameters | Description | default |
---|---|---|---|---|
date | date | string | null | 日期值,如果未提供,此组件将会运行在自动模式。 | null | |
onChange | func | (date: Date, text: String) => void | 日期被选中时将会被调用的回调函数。 | noop |
onCancel | func | () => void | 选择框被关闭时将会被调用的回调函数。 | noop |
show | bool | 直接控制选择框是否显示。 | false | |
withClear | bool | 是否要添加清空功能。 | false | |
autoOk | bool | 是否在选择日期后,直接关闭选择框。 | false | |
format | func | date => dateToString(date) | 一个用于格式化日期到字符串的自定义方法, | |
weekdayNames | array | arrayWith7Strings | 用户自定义的周一~周日的名称。 | |
weekdayShortNames | array | arrayWith7Strings | 用户自定义的周一~周日的短名称。 | |
monthNames | array | arrayWith12Strings | 用户自定义的每个月的名称。 | |
actionNames | shape | 用户自定义的选择框操作按钮的名称。 | ||
yearStart | number | 可选范围的起始年份。 | 1917 | |
yearEnd | number | 可选范围的结束年份。 | 2200 |