时间选择
用于时间输入的固定时间点选择器。
可选时间范围是 00:00 到 23:59
固定时间点选择器
提供固定时间点列表供用户选择。
使用 el-time-select 标签,通过 start、end 和 step 指定开始时间、结束时间和时间步长。
时间格式
使用 format 控制时间(小时和分钟)的格式。
在此处查看 Day.js 所有可用格式的列表。
警告
注意大小写
固定时间范围
如果先选择了开始(结束)时间,则结束(开始)时间的选项状态会相应地改变。
API
属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string | — |
| disabled | 是否禁用时间选择器 | boolean | false |
| 可编辑 | 输入框是否可编辑 | boolean | true |
| 可清空 | 是否显示清除按钮 | boolean | true |
| 包含结束时间 2.9.3 | 选项中是否包含 end 指定的时间 | boolean | false |
| size | 输入框尺寸 | 枚举 | default |
| 占位符 | 非范围选择时的占位内容 | string | — |
| name 2.13.3 | 与原生输入框的 `name` 相同 | string | — |
| effect | Tooltip 的主题,内置主题:`dark` / `light` | 字符串 / 枚举 | light |
| 前缀图标 | 自定义前缀图标组件 | string / Component | 时钟 |
| clear-icon | 自定义清除图标组件 | string / Component | CircleClose |
| align | 开始时间 | string | 09:00 |
| 结束 | 结束时间 | string | 18:00 |
| 步长 | 时间步长 | string | 00:30 |
| 最小时间 | 最小时间,早于此时间的任何时间都将被禁用 | string | — |
| 最大时间 | 最大时间,晚于此时间的任何时间都将被禁用 | string | — |
| format | 设置时间格式 | 字符串 参见 格式 | HH:mm |
| empty-values 2.7.0 | 组件的空值,请参阅 config-provider | array | — |
| value-on-clear 2.7.0 | 清空时的返回值,请参阅 config-provider | string / number / boolean / Function | — |
| 浮层类名 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 | 在可清空的时间选择器中点击清空按钮时触发 | Function |
暴露
| 方法 | 描述 | 类型 |
|---|---|---|
| focus | 使输入框获取焦点 | Function |
| blur | 使输入框失去焦点 | Function |