跳到主要内容

TimeSelect 时间选择 ​

WebH5

固定步长时间选择。触发器风格与输入框一致,下拉面板为 start→end 按 step 生成的单列时间选项,选中即更新值;minTime/maxTime 之外的选项禁用。

何时使用 ​

从一组固定间隔的时间点中选择:预约时段、配送时间、排班整点。

何时不使用 ​

需要任意时刻(含分钟自由输入)用 TimePicker;需要日期+时间用 DatePicker。

Props ​

名称类型默认值说明
modelValuestring | null"null"绑定值,格式 'HH:mm',配合 v-model 使用
startstring"08:00"起始时间(含),格式 'HH:mm'
endstring"18:00"结束时间(含),格式 'HH:mm'
stepstring"00:30"间隔步长,格式 'HH:mm',如 '00:15' 表示每 15 分钟一档
placeholderstring"选择时间(取 locale 文案 timepicker.placeholder)"占位文本
disabledbooleanfalse禁用
clearablebooleanfalse可清空(有值时 hover 显示清空按钮)
minTimestring-可选最小时间(含),格式 'HH:mm',之外的选项禁用
maxTimestring-可选最大时间(含),格式 'HH:mm',之外的选项禁用

Events ​

名称载荷说明
update:modelValuestring | null选中或清空时间时触发
changestring | null选中或清空时间时触发
clearvoid点击清空按钮时触发

示例 ​

预约到店时间 ​

示例加载中…

15 分钟步长 + 可清空 ​

示例加载中…

限定可选区间(minTime/maxTime) ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 TimeSelect 文档(含手机预览)。