日期选择器面板

DatePicker 的下拉面板本体(经典双面板范围)。推荐 DatePickerPanel Pro

组件选型

组件说明
DatePicker输入框 + 面板
DatePickerPanel(本文档)仅面板
DatePickerPanel ProPro 长滚动单面板

单点选择

日期 date

2026 年7 月
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 浏览

范围类默认左右双面板unlink-panels 解除联动。

类型:
2026 年7 月
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

面板状态

边框 border

嵌入 DatePicker 时常用 :border="false"

无边框
2026 年7 月
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
2026 年7 月
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

禁用
2026 年7 月
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 的关系

场景建议
表单内选日期DatePicker
自定义弹层 / 内嵌面板DatePickerPanelDatePickerPanel Pro

本地化

日期相关的文案(月份、周起始日等)通过 国际化 配置。

API

属性

名称说明类型默认值
model-value / v-model绑定值;范围类型为长度 2 的数组Date / array / string / number
type选择器类型enumdate
border面板是否显示边框booleantrue
disabled是否禁用booleanfalse
editable是否可编辑(影响面板内输入类交互)booleantrue
clearable范围模式下是否显示清除booleantrue
format显示格式(推导时间列等)string
value-format绑定值格式;不指定则为 Datestring
date-format面板内日期展示格式string
time-format面板内时间展示格式string
default-value打开时默认展示的日期Date / array
default-time范围选中日期使用的时刻Date / array
disabled-date判断日期是否禁用的函数Function
cell-class-name单元格自定义类名Function
shortcuts快捷选项array[]
unlink-panels范围选择器取消左右面板联动booleanfalse
arrow-control时间是否使用箭头切换booleanfalse
show-week-number是否显示周数booleanfalse
show-footer是否显示页脚boolean
show-confirm是否显示确定按钮boolean
show-now是否显示「此刻」按钮booleantrue

事件

名称说明类型
update:modelValue绑定值变化Function
calendar-change日历所选日期更改(范围类型)Function
panel-change日期面板视图切换Function
visible-change可见性变化Function

插槽

名称说明
sidebar侧边栏快捷选项区域

Copyright 2025 Winning Health 版权所有