DatePickerPane 日期选择器面板 beta
DatePickerPanel是DatePicker的核心组件。
选择某一天
以”日“为基本单位,基础的日期选择控件
2025 October
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
28 | 29 | 30 | 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 | 7 | 8 |
边框
默认情况下,边框是默认的,如果你不想要边框请参考示例。 例如,DatePicker不继承border。
No border:
2025 October
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
28 | 29 | 30 | 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 | 7 | 8 |
2025 October
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
28 | 29 | 30 | 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 | 7 | 8 |
禁用
"禁用"属性决定日期选择器是否完全禁用。
Disabled
2025 October
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
28 | 29 | 30 | 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 | 7 | 8 |
展示类型
时间面板的类型由 type 属性指定。
Type:
2025 October
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |
|---|---|---|---|---|---|---|
28 | 29 | 30 | 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 | 7 | 8 |
本地化
由于 Element Plus 的默认语言为英语,如果你需要设置其它的语言,请参考国际化文档。
要注意的是:日期相关的文字(月份,每一周的第一天等等) 也都进行了本地化配置。
应用开发接口(API)
属性
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值,如果是 range 选择器,数组长度应为 2 | number / string / Date / array | '' |
| 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 | 是否在日期选择器中显示页脚 ^[enum]'dates' \| 'months' \| 'years' \| 'datetime' \| 'datetimerange' | 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 | 下一年图标 |