跳到主要内容

TimePicker 时间选择 ​

WebH5

时间选择器。触发器风格与输入框一致,下拉面板为时/分两列滚动列表,分钟列按 step 步长生成,选中即更新值。

何时使用 ​

需要用户选择一个具体时刻:预约时间、营业时间、提醒时间等。

何时不使用 ​

需要时间范围或精确到秒的场景(本组件仅 HH:mm);移动端原生时间输入更合适时用原生 input[type=time]。

Props ​

名称类型默认值说明
modelValuestring | null"null"绑定值,格式 'HH:mm',配合 v-model 使用
placeholderstring"选择时间(取 locale 文案 timepicker.placeholder)"占位文本
disabledbooleanfalse禁用
clearablebooleanfalse可清空(有值时 hover 显示清空按钮)
stepnumber30分钟步长,如 30 表示 00/30,15 表示 00/15/30/45

Events ​

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

示例 ​

基础 ​

示例加载中…

15 分钟步长 ​

示例加载中…

可清空 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

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