TimePicker 时间选择器

用于选择或输入日期

任意时间点

可以选择任意时间

提供了两种交互方式:默认情况下通过鼠标滚轮进行选择,打开arrow-control属性则通过界面上的箭头进行选择。

限制时间选择范围

您也可以限制时间选择范围。

通过 disabledHours,disabledMinutes 和 disabledSeconds 限制可选时间范围。,

任意时间范围

可选择任意的时间范围

添加is-range属性即可选择时间范围。同样支持 arrow-control 属性。

TimePicker API

TimePicker Attributes

属性名说明类型默认值
value绑定值,范围模式传长度为 2 的数组Date / array`[Date, Date]` / number / string—
is-range是否选择时间范围booleanfalse
format输入框显示格式stringHH:mm:ss
value-format绑定值格式,省略时绑定值是 Datestring—
placeholder非范围模式的占位文本string—
start-placeholder范围模式起始占位文本string—
end-placeholder范围模式结束占位文本string—
range-separator范围分隔符string'-'
disabled是否禁用booleanfalse
readonly是否只读booleanfalse
editable输入框是否可编辑booleantrue
clearable是否显示清空按钮booleantrue
size尺寸enum`'large' | 'default' | 'small'`—
arrow-control是否用箭头按钮选择时间booleanfalse
default-value面板默认时间Date / array`[Date, Date]`—
disabled-hours不可选的小时Function`(role: string, comparingDate?: Day) => number[]`—
disabled-minutes不可选的分钟Function`(hour: number, role: string, comparingDate?: Day) => number[]`—
disabled-seconds不可选的秒Function`(hour: number, minute: number, role: string, comparingDate?: Day) => number[]`—
id / name原生 id / name,范围模式可传数组string / array—
aria-label同原生 aria-labelstring—
tabindex输入框 tabindexstring / number0
prefix-icon自定义前缀图标ReactNodeClock
clear-icon自定义清空图标ReactNodeCircleClose
popper-class浮层自定义类名string—
popper-style浮层自定义样式string / object—
teleported浮层是否挂载到 bodybooleantrue
placement浮层位置enum`Placement`bottom
fallback-placements翻转兜底位置列表array['bottom','top','right','left']
save-on-blur失焦时未选值是否自动填入当前时间booleantrue
automatic-dropdown聚焦输入框时是否自动弹出面板booleantrue
empty-values空值集合array—
value-on-clear清空时返回的值string / number / boolean / Function—
class-name / style根元素类名与样式string / object—

TimePicker Events

事件名说明参数
onChange绑定值变化(对应 v-model)Function`(value: Date \
onValueChange面板关闭时,绑定值相对打开面板时发生变化(对应 change);清空时无条件触发Function`(value: Date \
visibleChange面板显隐变化(对应 visible-change)Function`(visible: boolean) => void`
focus / blur输入框聚焦 / 失焦Function`(event: FocusEvent) => void`
clear点击清空图标Function`() => void`

事件 prop 在 React 侧统一写成 `onXxx`:`onChange` / `onValueChange` / `onVisibleChange` / `onFocus` / `onBlur` / `onClear`。

TimePicker Exposes

名称说明类型
focus让输入框获得焦点Function`() => void`
blur让输入框失焦Function`() => void`
handleOpen打开面板Function`() => void`
handleClose关闭面板Function`() => void`

通过 `ref` 传入即可取得上述方法。

子组件

组件对应官方说明
TimePanelpanel-time-pick.vue单点时间面板
TimeRangePanelpanel-time-range.vue范围时间面板
TimeSpinnerbasic-time-spinner.vue时 / 分 / 秒三列选择器