TimeSelect 时间选择
使用时间选择器来选择时间。
可选时间范围为 00:00 至 23:59
固定时间选择器
提供一个固定的时间列表供用户选择。
时间格式
使用 format 控制时间格式(小时和分钟)。
点击这里查看 Day.js 中所有可用的格式。
警告
注意大小写
固定时间范围
如果先选择开始(结束)时间,那么结束(开始)时间的状态会相应地改变。
API
属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string | — |
| disabled | TimeSelect 是否被禁用 | boolean | false |
| 可编辑 | 输入框是否可编辑 | boolean | true |
| 可清空 | 是否显示清除按钮 | boolean | true |
| include-end-time 2.9.3 | 是否将 end 时间包含在选项中 | boolean | false |
| size | 输入框尺寸 | 枚举 | default |
| 占位符 | 非范围选择时的占位内容 | string | — |
| 名称 | 与原生输入框的 `name` 相同 | string | — |
| effect | Tooltip 的主题,内置主题:`dark` / `light` | string / enum | light |
| 前缀图标 | 自定义前缀图标组件 | string / Component | 时钟图标 |
| clear-icon | 自定义清除图标组件 | string / Component | CircleClose |
| 开始时间 | 开始时间 | string | 09:00 |
| 结束时间 | 结束时间 | string | 18:00 |
| 步长 | 时间步长 | string | 00:30 |
| min-time | 最小时间,任何早于此时间的时间都将被禁用 | string | — |
| max-time | 最大时间,任何晚于此时间的时间都将被禁用 | string | — |
| format | 设置时间格式 | string 参见 格式 | HH:mm |
| empty-values 2.7.0 | 组件的空值,参见 config-provider | array | — |
| value-on-clear 2.7.0 | 清除返回值,参见 config-provider | string / number / boolean / Function | — |
| popper-class 2.11.4 | TimeSelect 下拉列表的自定义类名 | string | '' |
| popper-style 2.11.4 | TimeSelect 下拉列表的自定义样式 | string / object | — |
事件
| 名称 | 描述 | 类型 |
|---|---|---|
| change | 用户确认选定的值时触发 | Function |
| blur | 在 Input 失去焦点时触发 | Function |
| focus | 在 Input 获得焦点时触发 | Function |
| clear 2.7.7 | 在可清空的 TimeSelect 组件中点击清除图标时触发 | Function |
暴露
| 方法 | 描述 | 类型 |
|---|---|---|
| focus | 使输入框获取焦点 | Function |
| blur | 使输入组件失焦 | Function |