TimeSelect 时间选择器
用于选择或输入时间。
可用的时间范围是 00:00 到 23:59
固定时间选择器
提供一个固定的时间列表供用户选择。
使用 el-time-select
标签,并为它指定 start
、end
和 step
属性来设置起始时间、结束时间和步长。
时间格式
使用 format
控制时间(小时和分钟)的格式。
在这里查看 所有可用格式列表。
警告
注意大小写
固定时间范围
如果先选择了开始(结束)时间,那么结束(开始)时间的选择项的状态会相应地改变。
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 | Clock 时钟 |
clear-icon | 自定义清除图标组件 | string / Component | CircleClose |
开始 | 开始时间 | string | 09:00 |
结束 | 结束时间 | string | 18:00 |
步长 | 时间步长 | string | 00:30 |
最小时间 | 最小时间,早于该时间的将被禁用 | string | — |
最大时间 | 最大时间,晚于该时间的将被禁用 | 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 | — |
事件
名称 | 描述 | 类型 |
---|---|---|
change | 用户确认选定的值时触发 | Function |
blur | 在 Input 失去焦点时触发 | Function |
focus | 在 Input 获得焦点时触发 | Function |
clear 2.7.7 | 在可清空的 TimeSelect 组件中点击清除图标时触发 | Function |
暴露
方法 | 描述 | 类型 |
---|---|---|
focus | 使输入框获取焦点 | Function |
blur | 使输入组件失焦 | Function |