DatePickerPane 日期选择器面板 beta
DatePickerPanel
是DatePicker
的核心组件。
选择某一天
以”日“为基本单位,基础的日期选择控件
2025 September
Sun | Mon | Tue | Wed | Thu | Fri | Sat |
---|---|---|---|---|---|---|
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 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9 | 10 | 11 |
边框
默认情况下,边框是默认的,如果你不想要边框请参考示例。 例如,DatePicker
不继承border
。
No border:
2025 September
Sun | Mon | Tue | Wed | Thu | Fri | Sat |
---|---|---|---|---|---|---|
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 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9 | 10 | 11 |
2025 September
Sun | Mon | Tue | Wed | Thu | Fri | Sat |
---|---|---|---|---|---|---|
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 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9 | 10 | 11 |
禁用
"禁用"属性决定日期选择器是否完全禁用。
Disabled
2025 September
Sun | Mon | Tue | Wed | Thu | Fri | Sat |
---|---|---|---|---|---|---|
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 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9 | 10 | 11 |
展示类型
时间面板的类型由 type
属性指定。
Type:
2025 September
Sun | Mon | Tue | Wed | Thu | Fri | Sat |
---|---|---|---|---|---|---|
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 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9 | 10 | 11 |
本地化
由于 Element Plus 的默认语言为英语,如果你需要设置其它的语言,请参考国际化文档。
要注意的是:日期相关的文字(月份,每一周的第一天等等) 也都进行了本地化配置。
应用开发接口(API)
属性
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值,如果它是数组,长度应该是 2 | number / string / object | '' |
border | 日期选择器是否有边框 | boolean | true |
disabled | 禁用 | boolean | false |
clearable | 是否显示清除按钮 | boolean | true |
type | 选择器类型,默认是普通选择器 | enum | date |
default-value | 可选,选择器打开时默认显示的时间 | object | — |
default-time | 范围选择时选中日期所使用的当日内具体时刻 | object | — |
value-format | 可选,绑定值的格式。 不指定则绑定值为 Date 对象 | string | — |
date-format | 可选,输入框内部面板中显示的日期格式 | string see date formats | YYYY-MM-DD |
time-format | 可选,输入框内部面板中显示的时间格式 | string see date formats | HH:mm:ss |
unlink-panels | 在范围选择器里取消两个日期面板之间的联动 | boolean | false |
disabled-date | 一个用来判断该日期是否被禁用的函数,接受一个 Date 对象作为参数。 应该返回一个 Boolean 值。 | Function | — |
shortcuts | 设置快捷选项,需要传入数组对象 | object | [] |
cell-class-name | 设置自定义类名 | Function | — |
show-footer | whether to show footer where the date picker is one enum | boolean | false |
show-confirm | 是否显示确定按钮 | boolean | false |
show-week-number | 显示周数(除周外) | boolean | false |
Events
名称 | 详情 | 类型 |
---|---|---|
calendar-change | 在日历所选日期更改时触发 仅限“range”类型。 | Function |
panel-change | 当日期面板改变时触发。 | Function |
插槽
名称 | 详情 |
---|---|
default | 自定义单元格内容 |
prev-month | 上个月的图标 |
next-month | 下个月的图标 |
prev-year | 上一年图标 |
next-year | 下一年图标 |