Skip to content

日期选择器

用法

设置默认值

通过 defaultValue 选项设置默认值,设置为 'today' 可以将默认值设置为当天。

格式化

通过 format 选项设置日期格式化形式,支持日期辅助方法 formatDate 中的所有格式。

限制日期范围

通过 minDatemaxDate 来限制可选的日期范围。

自定义菜单

通过 menu 选项可以在弹出面板侧面显示一个自定义菜单,通过 actions 可以自定义底部工具栏上的按钮。在菜单项和按钮上通过 [data-set-date] 属性指定点击按钮时要设定的日期。

自定义侧边菜单

通过 menu 选项可以在弹出面板左侧显示一个自定义菜单,在菜单项配置上通过 [data-set-date] 属性指定点击菜单项时要设定的日期。

自定义底部按钮

通过 actions 可以自定义底部工具栏上的按钮,在菜单项和按钮上通过 [data-set-date] 属性指定点击按钮时要设定的日期。

选项

名称类型默认值说明
classNameanynull组件根元素的类名。
styleobjectnull组件根元素的样式。
tagNamestringnull组件根元素的标签名。
attrsobjectnull附加到组件根元素上的属性。
clickType'toggle''open'null点击类型,toggle 表示点击按钮时切换显示隐藏,open 表示点击按钮时只打开。
namestringnull作为表单项的名称。
defaultValue'today'stringnull默认值。
onChangefunctionnull值变更时的回调函数。
disabledbooleannull是否禁用。
readonlybooleannull是否只读,不允许手动修改。
requiredbooleannull是否必须提供值(不能清除和选择空值)。
placeholderstringnull输入框上占位文本。
formatstringnull日期格式,默认 yyyy-MM-dd。
iconstringobjectnull在输入框右侧显示的图标。
weekNamesstring[]null星期名称,索引为 0 表示周日。
monthNamesstring[]null月份名称,索引为 0 表示一月份。
yearTextstringnull用于显示年份的格式化文本。
todayTextstringnull用于显示“今天”的文本。
clearTextstringnull用于显示“清除”的文本。
weekStartnumbernull一周从星期几开始,默认 1。
minDateDateLikenull最小可选的日期。
maxDateDateLikenull最大可选的日期。
menuobject[]objectnull左侧显示的菜单设置。
actionsobject[]objectnull底部工具栏设置。
onInvalidfunctionnull日期值无效时的回调函数。

MIT License (MIT)