开发预览 更新于 2026-05-10

TimePicker 时间选择器

触发器 + 三列滚动面板的时间选择器,支持时分秒,可配 DatePicker 用于"日期 + 时间"场景。

基础用法

v-model / value 是字符串,格式 HH:mmHH:mm:ss(开启 showSeconds 时)。clearable 显示清除按钮。

时(HH:mm)
含秒(HH:mm:ss)
已选:09:30 / (无)
<CfTimePicker v-model="t1" clearable />
<CfTimePicker v-model="t2" show-seconds clearable />
<CfTimePicker value={t1} onChange={setT1} clearable />
<CfTimePicker value={t2} onChange={setT2} showSeconds clearable />

API

属性类型默认值说明
value / modelValuestring | null受控值,格式 HH:mmHH:mm:ss
defaultValuestring | nullnull非受控初始值
placeholderstring'请选择时间'未选中时占位文案
size'sm' | 'md' | 'lg''md'触发器尺寸
disabledbooleanfalse禁用
clearablebooleanfalse显示清除按钮
showSecondsbooleanfalse显示秒列,输出格式变为 HH:mm:ss

事件:onChange(value) —— 时间变化时触发。

反馈与讨论

TimePicker 时间选择器 的讨论

0
0 / 600
一键发送
正在加载评论...