Appearance
DatePicker 日期选择器
用于选择或输入日期,支持单选、多选、节假日标记等高级功能。
基础用法
最基本的日期选择。
格式化
使用 format 指定显示格式,value-format 指定绑定值的格式。
多选模式 (Unique)
设置 type="dates" 开启多选模式。支持 multiple-limit 限制数量。
节假日高亮 (Unique)
通过 holidays 属性传入节假日列表(字符串数组)或判断函数,高亮特定日期。
自定义单元格内容
使用 cell 插槽自定义日期格子的内容,可用于显示农历、价格等信息。
范围选择
设置 type="daterange" 开启日期范围选择模式。
DatePicker 属性
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | Date / String / Number / Array | - |
| type | 显示类型 | 'date' / 'dates' / 'daterange' | 'date' |
| size | 尺寸 | 'large' / 'default' / 'small' | 'default' |
| placeholder | 占位文本 | string | - |
| start-placeholder | 范围选择时开始日期的占位内容 | string | - |
| end-placeholder | 范围选择时结束日期的占位内容 | string | - |
| range-separator | 范围选择时的分隔符 | string | '-' |
| disabled | 是否禁用 | boolean | false |
| clearable | 是否显示清除按钮 | boolean | true |
| format | 显示在输入框中的格式 | string | 'YYYY-MM-DD' |
| value-format | 绑定值的格式,不指定则绑定 Date 对象 | string | - |
| readonly | 原生 readonly | boolean | false |
| editable | 输入框是否可输入 | boolean | true |
| holidays | 节假日/特殊日期高亮 | string[] / (date) => boolean | [] |
| multiple-limit | 多选模式下的最大选择数量 | number | 0 (unlimited) |
DatePicker 事件
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 用户确认选定的值时触发 | (value: DateModelType) |
| visible-change | 下拉框出现/隐藏时触发 | (visibility: boolean) |
| focus | 输入框获得焦点 | (e: FocusEvent) |
| blur | 输入框失去焦点 | (e: FocusEvent) |
DatePicker 插槽
| 插槽名 | 说明 | 参数 |
|---|---|---|
| cell | 自定义日期单元格内容 | '{ date, type, isSelected }' |