TimeSelect 时间选择
WebH5
固定步长时间选择。触发器风格与输入框一致,下拉面板为 start→end 按 step 生成的单列时间选项,选中即更新值;minTime/maxTime 之外的选项禁用。
何时使用
从一组固定间隔的时间点中选择:预约时段、配送时间、排班整点。
何时不使用
需要任意时刻(含分钟自由输入)用 TimePicker;需要日期+时间用 DatePicker。
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 分钟一档 |
placeholder | string | "选择时间(取 locale 文案 timepicker.placeholder)" | 占位文本 |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空(有值时 hover 显示清空按钮) |
minTime | string | - | 可选最小时间(含),格式 'HH:mm',之外的选项禁用 |
maxTime | string | - | 可选最大时间(含),格式 'HH:mm',之外的选项禁用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | null | 选中或清空时间时触发 |
change | string | null | 选中或清空时间时触发 |
clear | void | 点击清空按钮时触发 |
示例
预约到店时间
示例加载中…
15 分钟步长 + 可清空
示例加载中…
限定可选区间(minTime/maxTime)
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 TimeSelect 文档(含手机预览)。