DatePickerPanel 测试版
DatePickerPanel
是 DatePicker
的核心组件。
输入日期
以「日」为基本单位的日期选择器。
边框
默认情况下,日期选择器面板是有边框的,但在某些情况下您可能不想要它。 例如 DatePicker
不继承 border
。
无边框
2025年 八月
日 | 一 | 二 | 三 | 四 | 五 | 六 |
---|---|---|---|---|---|---|
27 | 28 | 29 | 30 | 31 | 1 | 2 |
3 | 4 | 5 | 6 | 7 | 8 | 9 |
10 | 11 | 12 | 13 | 14 | 15 | 16 |
17 | 18 | 19 | 20 | 21 | 22 | 23 |
24 | 25 | 26 | 27 | 28 | 29 | 30 |
31 | 1 | 2 | 3 | 4 | 5 | 6 |
2025年 八月
日 | 一 | 二 | 三 | 四 | 五 | 六 |
---|---|---|---|---|---|---|
27 | 28 | 29 | 30 | 31 | 1 | 2 |
3 | 4 | 5 | 6 | 7 | 8 | 9 |
10 | 11 | 12 | 13 | 14 | 15 | 16 |
17 | 18 | 19 | 20 | 21 | 22 | 23 |
24 | 25 | 26 | 27 | 28 | 29 | 30 |
31 | 1 | 2 | 3 | 4 | 5 | 6 |
禁用状态
disabled
属性决定了日期选择器是否完全禁用。
类型
度量由 type
属性决定。
本地化
默认的区域设置为英文,如果你需要使用其他语言,请参考 国际化
注意,日期时间区域设置 (月份名称、每周第一天等) 也在本地化配置中。
API
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值,如果它是数组,长度应该是 2 | number / string / object | '' |
边框 | 日期选择器是否有边框 | boolean | true |
disabled | DatePicker 是否被禁用 | boolean | false |
可清空 | 是否显示清除按钮 | boolean | true |
type | 选择器类型 | 枚举 | 日 |
default-value | 可选,选择器打开时默认显示的时间 | object | — |
默认时间 | 可选,选择日期范围时使用的时间值 | object | — |
value-format | 可选,绑定值的格式。 如果未指定,则绑定值为 Date 对象 | string | — |
日期格式 | 可选,在输入框的内部面板中显示的日期格式 | string 查看 日期格式 | YYYY-MM-DD |
时间格式 | 可选,在输入框的内部面板中显示的时间格式 | string 查看 日期格式 | HH:mm:ss |
取消面板链接 | 在范围选择器中取消两个日期面板的链接 | boolean | false |
禁用日期 | 一个用来判断该日期是否被禁用的函数,接受一个日期作为参数。应该返回一个布尔值 | Function | — |
快捷选项 | 设置快捷选项的对象数组 | object | [] |
单元格类名 | 设置自定义的类名 | Function | — |
显示页脚 | 是否显示页脚 | boolean | false |
显示确认 | 是否显示确认按钮 | boolean | false |
显示周数 | 在周旁边显示周数 | boolean | false |
事件
名称 | 描述 | 类型 |
---|---|---|
日历更改 | 本日历所选日期发生更改时触发。 仅适用于 range | Function |
面板更改 | 在点击导航按钮时触发。 | Function |
插槽
名称 | 描述 |
---|---|
default | 自定义单元格内容 |
上个月 | 上个月图标 |
下个月 | 下个月图标 |
上一年 | 上一年图标 |
下一年 | 下一年图标 |