TimePicker 时间选择
WebH5
时间选择器。触发器风格与输入框一致,下拉面板为时/分两列滚动列表,分钟列按 step 步长生成,选中即更新值。
何时使用
需要用户选择一个具体时刻:预约时间、营业时间、提醒时间等。
何时不使用
需要时间范围或精确到秒的场景(本组件仅 HH:mm);移动端原生时间输入更合适时用原生 input[type=time]。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | null | "null" | 绑定值,格式 'HH:mm',配合 v-model 使用 |
placeholder | string | "选择时间(取 locale 文案 timepicker.placeholder)" | 占位文本 |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空(有值时 hover 显示清空按钮) |
step | number | 30 | 分钟步长,如 30 表示 00/30,15 表示 00/15/30/45 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | null | 选中或清空时间时触发 |
change | string | null | 选中或清空时间时触发 |
clear | void | 点击清空按钮时触发 |
示例
基础
示例加载中…
15 分钟步长
示例加载中…
可清空
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 TimePicker 文档(含手机预览)。