时间选择器
用于选择或输入时刻(经典版)。推荐 TimePicker Pro。
组件选型
| 组件 | 说明 |
|---|---|
| DatePicker | 日期 |
| DateTimePicker | 日期 + 时刻 |
| TimePicker(本文档) | 时刻 / 时刻范围 |
| DatePickerPanel | 独立面板 |
单点选择
任意时刻
滚轮或 arrow-control 箭头;可配置「此刻」按钮。
默认
此刻:
箭头控制
轻量化
禁用部分时段
disabledHours / disabledMinutes / disabledSeconds。
范围选择
时刻范围 is-range
-
-
API
Attributes
| 参数 | 说明 | 类型 | 默认值 | Version |
|---|---|---|---|---|
| model-value / v-model | 绑定值,如果它是数组,长度应该是 2 | number / string / object | '' | |
| readonly | 完全只读 | boolean | false | |
| disabled | 禁用 | boolean | false | |
| editable | 文本框可输入 | boolean | true | |
| clearable | 是否显示清除按钮 | boolean | true | |
| size | 输入框尺寸 | enum | — | |
| placeholder | 非范围选择时的占位内容 | string | '' | |
| start-placeholder | 范围选择时开始日期的占位内容 | string | — | |
| end-placeholder | 范围选择时结束日期的占位内容 | string | — | |
| is-range | 是否为时间范围选择 | boolean | false | |
| arrow-control | 是否使用箭头进行时间选择 | boolean | false | |
| popper-class | TimePicker 下拉框的类名 | string | '' | |
| teleported | 是否使用 teleport;为 true 时下拉层挂载到 append-to 指定位置 | boolean | true | |
| append-to | 下拉层挂载到哪个 DOM 元素 | string | — | |
| range-separator | 选择范围时的分隔符 | string | '-' | |
| format | 显示在输入框中的格式 | string see date formats | — | |
| default-value | 可选,选择器打开时默认显示的时间 | Date / object | — | |
| value-format | 可选,绑定值的格式。 不指定则绑定值为 Date 对象 | string 参考 日期格式 | — | |
| id | 等价于原生 input id 属性 | string / object | — | |
| name | 等价于原生 input name 属性 | string | '' | |
| aria-label a11y | 等价于原生 input aria-label 属性 | string | — | |
| prefix-icon | 自定义前缀图标 | string / Component | ||
| clear-icon | 自定义清除图标 | string / Component | CircleCloseFilled | |
| disabled-hours | 禁止选择部分小时选项 | Function | — | |
| disabled-minutes | 禁止选择部分分钟选项 | Function | — | |
| disabled-seconds | 禁止选择部分秒选项 | Function | — | |
| tabindex | 输入框的 tabindex | string / number | 0 | |
| empty-values | 组件的空值配置 参考 config-provider | array | — | |
| value-on-clear | 清空选项的值 参考 config-provider | string / number / boolean / Function | — | |
| label a11y deprecated | 等价于原生 input aria-label 属性 | string | — | |
| plain | 朴素的 TimePicker | boolean | false | V0.0.8 |
| emit-formatted-value | change 事件是否附带格式化字符串(第二参数) | boolean | false | V0.0.8 |
事件
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 用户确认选定的值时触发 | Function |
| blur | 在组件 Input 失去焦点时触发 | Function |
| focus | 在组件 Input 获得焦点时触发 | Function |
| clear | 可清空的模式下用户点击清空按钮时触发 | Function |
| visible-change | 当 TimePicker 的下拉列表出现/消失时触发 | Function |
暴露
| 名称 | 说明 | Type |
|---|---|---|
| focus | 使组件获取焦点 | Function |
| blur | 使组件失去焦点 | Function |
| handleOpen | 打开时间选择器弹窗 | Function |
| handleClose | 关闭时间选择器弹窗 | Function |
Copyright 2025 Winning Health 版权所有

