Skip to content

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是否禁用booleanfalse
clearable是否显示清除按钮booleantrue
format显示在输入框中的格式string'YYYY-MM-DD'
value-format绑定值的格式,不指定则绑定 Date 对象string-
readonly原生 readonlybooleanfalse
editable输入框是否可输入booleantrue
holidays节假日/特殊日期高亮string[] / (date) => boolean[]
multiple-limit多选模式下的最大选择数量number0 (unlimited)

DatePicker 事件

事件名说明回调参数
change用户确认选定的值时触发(value: DateModelType)
visible-change下拉框出现/隐藏时触发(visibility: boolean)
focus输入框获得焦点(e: FocusEvent)
blur输入框失去焦点(e: FocusEvent)

DatePicker 插槽

插槽名说明参数
cell自定义日期单元格内容'{ date, type, isSelected }'