TimeSelect 时间选择
uni-appH5微信小程序App
跨端时间档位选择器,支持起止时间和间隔步长。
何时使用
从一组固定间隔的时间点中选择:预约时段、配送时间、排班整点。
何时不使用
需要任意时刻(含分钟自由输入)用 TimePicker;需要日期+时间用 DatePicker。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | null | null | 绑定值,格式 'HH:mm',配合 v-model 使用 |
start | string | "08:00" | 起始时间(含),格式 'HH:mm' |
end | string | "18:00" | 结束时间(含),格式 'HH:mm' |
step | string | "00:30" | 间隔步长,格式 'HH:mm',如 '00:15' 表示每 15 分钟一档 |
label | string | "" | 选择器上方标签文本 |
placeholder | string | "请选择时间" | 占位文本 |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空(有值时 hover 显示清空按钮) |
minTime | string | - | 可选最小时间(含),格式 'HH:mm',之外的选项禁用 |
maxTime | string | - | 可选最大时间(含),格式 'HH:mm',之外的选项禁用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 选中或清空时间时触发 |
clear | void | 点击清空按钮时触发 |
change | string | null | 选中或清空时间时触发 |
示例
营业时间槽
vue
<TimeSelect v-model="time" label="到店时间" />自定义步长
vue
<TimeSelect v-model="time" label="会议时间" start="09:00" end="21:00" step="01:00" />禁用
vue
<TimeSelect v-model="time" label="禁用" disabled />可选时间范围
vue
<TimeSelect v-model="m1" label="到店时间" min-time="09:00" max-time="18:00" clearable />