DatePickerPanel 日期选择面板 beta
DatePickerPanel 是 DatePicker 的核心组件。
输入日期
以「日」为基本单位的日期选择器。
边框
默认情况下,日期选择器面板是有边框的,但在某些情况下你可能不希望这样。例如,DatePicker 没有继承 border。
禁用状态
disabled 属性决定了日期选择器是否完全禁用。
类型
测量的单位由 type 属性决定。
本地化
默认的区域设置为英文,如果你需要使用其他语言,请参考 国际化
注意,日期时间区域设置 (月份名称、每周第一天等) 也在本地化配置中。
API
属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值,如果它是一个 range 选择器,数组的长度应该是 2 | number / string / Date / array | '' |
| 边框 | 日期选择器是否有边框 | 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 | — |
| 显示底部 | 当日期选择器是一个 enum 时,是否显示底部 | boolean | false |
| 显示确认 | 是否显示确认按钮 | boolean | false |
| 显示周数 | 在周旁边显示周数 | boolean | false |
事件
| 名称 | 描述 | 类型 |
|---|---|---|
| 日历更改 | 本日历所选日期发生更改时触发。 仅适用于 range | Function |
| 面板更改 | 在点击导航按钮时触发。 | Function |
插槽
| 名称 | 描述 |
|---|---|
| default | 自定义单元格内容 |
| 上个月 | 上个月图标 |
| 下个月 | 下个月图标 |
| 上一年 | 上一年图标 |
| 下一年 | 下一年图标 |