TimePicker 时间选择器
uni-appH5微信小程序App
封装 uni-app 原生 time picker 的跨端时间选择器。
何时使用
需要用户选择一个具体时刻:预约时间、营业时间、提醒时间等。
何时不使用
需要时间范围或精确到秒的场景(本组件仅 HH:mm);移动端原生时间输入更合适时用原生 input[type=time]。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | null | null | 绑定值,格式 'HH:mm',配合 v-model 使用 |
label | string | "" | 选择器上方标签文本 |
placeholder | string | "请选择时间" | 占位文本 |
min | string | "" | 可选最小时间,格式 HH:mm |
max | string | "" | 可选最大时间,格式 HH:mm |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空(有值时 hover 显示清空按钮) |
step | number | 30 | 分钟步长,如 30 表示 00/30,15 表示 00/15/30/45 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 选中或清空时间时触发 |
clear | void | 点击清空按钮时触发 |
change | string | null | 选中或清空时间时触发 |
示例
基础用法
vue
<TimePicker v-model="time" label="提醒时间" />禁用
vue
<TimePicker v-model="time" label="禁用" disabled />限定范围
vue
<TimePicker v-model="time" label="营业时间" min="08:00" max="22:00" />清空与分钟步长
vue
<TimePicker v-model="time" label="预约时间" clearable :step="15" />