DatePicker 日期选择器
概述
当用户需要输入一个日期,可以点击标准输入框,弹出日期面板进行选择。
代码示例
API
属性 | 说明 | 类型 | 默认值 |
value | 日期的值,可以使用v-model实现数据的双向绑定 | Date、Array、Number | null |
model | 模式,可选值有single 、range 、 multiple | String | single |
format | 时间格式:YYYY-MM-DD HH:mm:ss | String | YYYY-MM-DD |
maxDate | 最大可选时间 | Date | null |
minDate | 最小可选时间 | Date | null |
maxRange | 最大可选区间,格式为 /\d+[DMY]/ | String | null |
disable | 禁止的时间,格式可以为:[Date, Function, {from: Date, to: Date}] | Array | null |
enable | 可用的时间,格式可以为:[Date, Function, {from: Date, to: Date}] | Array | null |
disabledDate | 禁止时间函数,参数为对应的时间 Date,执行结果为true则禁止 | Function | null |
rangeSeparator | 区间选择中间的分割符号,只在 model 为 range 时生效 | String | ~ |
showConfirm | 是否显示确认按钮,在多选强制为true,其他情况默认为 false | Boolean | - |
onlyMonth | 是否只选择月份(兼容老的API,尽量使用 format代替) | Boolean | false |
enableTime | 是否显示时间(兼容老的API,尽量使用 format代替) | Boolean | false |
enableSeconds | 是否显示秒(兼容老的API,尽量使用 format代替) | Boolean | false |
属性 | 说明 | 类型 | 默认值 |
placeholder | 未选择时间时的提示语 | String | 请选择日期 |
icon | 输入框左边的 icon | String | calendar |
clearable | 是否显示清除 icon | Boolean | false |
position | 弹窗的位置,会根据窗口大小自适应,可选值bottomLeft bottomRight topLeft topRight | String | bottomLeft |
readonly | 是否只读 | Boolean | false |
disabled | 是否禁用 | Boolean | false |
事件名 | 说明 | 返回值 |
on-input | 输入时触发 | (value) => void |
on-change | 值改变时触发 | (value) => void |
on-enter | 焦点在input, 按下enter键触发 | (event) => void |
on-focus | 获取焦点时触发 | (event) => void |
on-blur | 失去焦点时触发 | (event) => void |
on-blur | 失去焦点时触发 | (event) => void |
DatePicker Props
属性 | 说明 | 类型 | 默认值 |
inline | 是否脱离文档流,ture则用relative定位,false则用absolute定位 | Boolean | true |
DatePicker Events
事件名 | 说明 | 返回值 |
on-change | 值改变时触发 | (value) => void |
on-finish | 选择结束触发 | () => void |