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 |