日期选择器
用法
设置默认值
通过 defaultValue
选项设置默认值,设置为 'today'
可以将默认值设置为当天。
格式化
通过 format
选项设置日期格式化形式,支持日期辅助方法 formatDate
中的所有格式。
限制日期范围
通过 minDate
和 maxDate
来限制可选的日期范围。
自定义菜单
通过 menu
选项可以在弹出面板侧面显示一个自定义菜单,通过 actions
可以自定义底部工具栏上的按钮。在菜单项和按钮上通过 [data-set-date]
属性指定点击按钮时要设定的日期。
自定义侧边菜单
通过 menu
选项可以在弹出面板左侧显示一个自定义菜单,在菜单项配置上通过 [data-set-date]
属性指定点击菜单项时要设定的日期。
自定义底部按钮
通过 actions
可以自定义底部工具栏上的按钮,在菜单项和按钮上通过 [data-set-date]
属性指定点击按钮时要设定的日期。
选项
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
className | any | null | 组件根元素的类名。 |
style | object | null | 组件根元素的样式。 |
tagName | string | null | 组件根元素的标签名。 |
attrs | object | null | 附加到组件根元素上的属性。 |
clickType | 'toggle' 'open' | null | 点击类型,toggle 表示点击按钮时切换显示隐藏,open 表示点击按钮时只打开。 |
name | string | null | 作为表单项的名称。 |
defaultValue | 'today' string | null | 默认值。 |
onChange | function | null | 值变更时的回调函数。 |
disabled | boolean | null | 是否禁用。 |
readonly | boolean | null | 是否只读,不允许手动修改。 |
required | boolean | null | 是否必须提供值(不能清除和选择空值)。 |
placeholder | string | null | 输入框上占位文本。 |
format | string | null | 日期格式,默认 yyyy-MM-dd。 |
icon | string object | null | 在输入框右侧显示的图标。 |
weekNames | string[] | null | 星期名称,索引为 0 表示周日。 |
monthNames | string[] | null | 月份名称,索引为 0 表示一月份。 |
yearText | string | null | 用于显示年份的格式化文本。 |
todayText | string | null | 用于显示“今天”的文本。 |
clearText | string | null | 用于显示“清除”的文本。 |
weekStart | number | null | 一周从星期几开始,默认 1。 |
minDate | DateLike | null | 最小可选的日期。 |
maxDate | DateLike | null | 最大可选的日期。 |
menu | object[] object | null | 左侧显示的菜单设置。 |
actions | object[] object | null | 底部工具栏设置。 |
onInvalid | function | null | 日期值无效时的回调函数。 |