日期选择器面板
DatePicker 的下拉面板本体(经典双面板范围)。推荐 DatePickerPanel Pro。
组件选型
| 组件 | 说明 |
|---|---|
| DatePicker | 输入框 + 面板 |
| DatePickerPanel(本文档) | 仅面板 |
| DatePickerPanel Pro | Pro 长滚动单面板 |
单点选择
日期 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 |
| 自定义弹层 / 内嵌面板 | DatePickerPanel 或 DatePickerPanel Pro |
本地化
日期相关的文案(月份、周起始日等)通过 国际化 配置。
API
属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值;范围类型为长度 2 的数组 | Date / array / string / number | — |
| type | 选择器类型 | enum | date |
| border | 面板是否显示边框 | boolean | true |
| disabled | 是否禁用 | boolean | false |
| editable | 是否可编辑(影响面板内输入类交互) | boolean | true |
| clearable | 范围模式下是否显示清除 | boolean | true |
| format | 显示格式(推导时间列等) | string | — |
| value-format | 绑定值格式;不指定则为 Date | string | — |
| 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 | 范围选择器取消左右面板联动 | boolean | false |
| arrow-control | 时间是否使用箭头切换 | boolean | false |
| show-week-number | 是否显示周数 | boolean | false |
| show-footer | 是否显示页脚 | boolean | — |
| show-confirm | 是否显示确定按钮 | boolean | — |
| show-now | 是否显示「此刻」按钮 | boolean | true |
事件
| 名称 | 说明 | 类型 |
|---|---|---|
| update:modelValue | 绑定值变化 | Function |
| calendar-change | 日历所选日期更改(范围类型) | Function |
| panel-change | 日期面板视图切换 | Function |
| visible-change | 可见性变化 | Function |
插槽
| 名称 | 说明 |
|---|---|
| sidebar | 侧边栏快捷选项区域 |
Copyright 2025 Winning Health 版权所有

