时间选择器

使用时间选择器进行时间输入。

时间列表会以底部弹层展开,而不是桌面端风格的箭头式交互。

任意时间选择器

可以选择任意时间点。

默认情况下,您可以滚动时间列表来选择时间,整个流程会保持在单列底部面板中。

起床时间选择单个时间点

时间列表可纵向滚动,并在页脚完成确认。

睡眠模式开始在强调清晰度时使用 24 小时制

第二个输入项展示了多个时间字段如何保持整齐堆叠。

限制时间范围

您还可以限制可选时间范围。

通过指定 disabledHours disabledMinutesdisabledSeconds 来限制时间范围。

可选时段仅允许选择 17:30 至 18:30

超出范围的时间会在面板中直接禁用,避免提交无效值。

任意时间范围

可以选择任意时间范围。

我们可以通过添加 is-range 属性来选择时间范围。范围模式会将起止时间一起保留在同一套面板里。

工作班次选择开始时间与结束时间

两个端点会始终保持在同一组视觉区域中,更便于快速浏览。

客服时段通过第二组范围管理其他时间安排

在编辑可用时段时,24 小时制通常会更清晰。

API

属性

名称描述类型默认值
model-value / v-model绑定值;范围模式下应为长度为 2 的数组Date / [Date, Date] / number / [number, number] / string / [string, string]''
readonly是否只读booleanfalse
disabled是否禁用booleanfalse
editable输入框是否可编辑booleantrue
clearable是否显示清除按钮booleantrue
size输入尺寸'large' | 'default' | 'small'
placeholder非范围模式下的占位文本string''
start-placeholder范围模式开始输入框占位文本string
end-placeholder范围模式结束输入框占位文本string
is-range是否开启时间范围模式booleanfalse
range-separator范围分隔符string'-'
format输入框中显示值的格式stringHH:mm:ss
value-format绑定值格式;未指定时返回 Datestring
id原生输入框 id,范围模式下可传数组string / [string, string]
name原生输入框 name,范围模式下可传数组string / [string, string]''
prefix-icon自定义前缀图标组件string / ComponentClock
clear-icon自定义清除图标组件string / ComponentCircleClose
disabled-hours返回不可选小时列表(role: string, comparingDate?: Dayjs) => number[]
disabled-minutes返回不可选分钟列表(hour: number, role: string, comparingDate?: Dayjs) => number[]
disabled-seconds返回不可选秒列表(hour: number, minute: number, role: string, comparingDate?: Dayjs) => number[]
tabindex输入框 tabindexstring / number0
empty-values 2.7.0自定义空值集合any[]
value-on-clear 2.7.0清空时返回的值string / number / boolean / Function
save-on-blur 2.13.4无值时聚焦后是否自动填入当前时间booleantrue
popper-class弹层自定义类名string''
popper-style弹层自定义样式string / object
aria-label a11y 2.7.2原生输入框 aria-labelstring

事件

名称描述类型
update:modelValue当绑定值更新时触发(value: Date | [Date, Date] | number | [number, number] | string | [string, string]) => void
change当用户确认一个值时触发(value: Date | [Date, Date] | number | [number, number] | string | [string, string]) => void
focus输入框聚焦时触发(event: FocusEvent) => void
blur输入框失焦时触发(event: FocusEvent) => void
clear 2.7.7点击清除按钮时触发() => void
visible-change弹层显示状态改变时触发(visible: boolean) => void

暴露

名称描述类型
focus聚焦输入框() => void
blur让输入框失焦() => void
handleOpen 2.2.16打开时间选择面板() => void
handleClose 2.2.16关闭时间选择面板() => void

类型声明

显示声明
ts
// TimePicker 默认输出 Date,也可通过 value-format 输出字符串或数字。