Time 时间选择器
选择时间的组件。
何时使用
当用户需要输入一个时间,可以点击输入框弹出时间面板进行选择。
基础用法
点击输入框弹出时间选择面板,支持时、分选择。通过 v-model 绑定时间值(格式 HH:mm)。
vue
<TTime v-model="time" placeholder="请选择时间" />预设值
传入预设时间值,面板初始化时自动定位到对应位置。
vue
<TTime :model-value="'14:30'" />带秒选择
设置 format="HH:mm:ss" 显示秒列,支持时、分、秒完整选择。
vue
<TTime :model-value="'09:15:30'" format="HH:mm:ss" />分钟步长
设置 minute-step 属性控制分钟选项的递增步长,可选 5、10、15、30 等。
vue
<TTime :minute-step="15" placeholder="步长15分钟" />尺寸
支持 sm、默认、lg 三种尺寸。
vue
<TTime size="sm" placeholder="小尺寸" />
<TTime placeholder="默认尺寸" />
<TTime size="lg" placeholder="大尺寸" />可清除
设置 clearable 后,面板底部显示清除按钮,可一键清空已选时间。
vue
<TTime :model-value="'10:00'" clearable />禁用
设置 disabled 禁用时间选择。
vue
<TTime disabled placeholder="禁用状态" />API
TTime 属性 (Props)
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
model-value | 时间值(v-model 绑定,格式 HH:mm 或 HH:mm:ss) | string | '' |
format | 显示格式 | 'HH:mm' | 'HH:mm:ss' | 'HH:mm' |
hour-step | 小时步长 | number | 1 |
minute-step | 分钟步长 | number | 1 |
second-step | 秒步长 | number | 1 |
disabled | 是否禁用 | boolean | false |
placeholder | 占位符文本 | string | '选择时间' |
size | 尺寸 | 'sm' | 'lg' | undefined |
clearable | 是否显示清除按钮 | boolean | false |
TTime 事件 (Emits)
| 事件名 | 说明 | 回调参数 |
|---|---|---|
update:model-value | 时间值变化时触发 | (value: string) => void |
change | 用户确认选择时触发 | (value: string) => void |