Time Input
@astryxdesign/core v0.7.1 · TimeInput
TimeInput Props
| Name | Type | Default | Description |
|---|---|---|---|
v-model | string | null | null | ISO time, HH:MM or HH:MM:SS. |
label | string | — | Required accessible name. |
hourFormat | '12h' | '24h' | '12h' | How the value is shown. The model stays 24-hour ISO. |
hasSeconds | boolean | false | Keep seconds in the value. |
increment | number | 1 | Minutes added or removed by the arrow keys. |
min | string | — | Earliest ISO time. |
max | string | — | Latest ISO time. |
presentation | 'text-input' | 'native' | 'adaptive-native' | 'adaptive-bottom-sheet' | 'popover' | 'bottom-sheet' | 'adaptive-native' | Typed field, platform time control, or hour and minute wheels. Omitted means typed text on a fine pointer and the platform control on a coarse pointer. adaptive-bottom-sheet uses wheels only on a coarse pointer; bottom-sheet always uses wheels. Seconds, a step other than 1, or a preset interval send the platform control back to typed text. The wheels are unaffected. An explicit value wins over nativePicker. |
isLabelHidden | boolean | false | Hides the label visually while keeping it accessible. labelHidden is the older name; either one hides it. |
containerClass | string | object | array | — | Class for the field container. Has no effect, and warns in development, inside InputGroup and in a horizontal-labels FormLayout. |
containerStyle | StyleValue | — | Inline style for the field container. Same targeting as containerClass. |
controlClass | string | object | array | — | Class for the bordered control box. A class written on the component lands here too, not on the inner input. |
controlStyle | StyleValue | — | Inline style for the bordered control box. |
hasClear | boolean | false | Shows a clear button. |
size | 'sm' | 'md' | 'lg' | 'md' | Field height. |
status | FieldStatusInput | — | Error, warning, or success. |
statusVariant | 'attached' | 'detached' | 'tooltip' | 'attached' | Where the status message sits. |
isDisabled | boolean | false | Disables the field. |
disabledMessage | string | — | Explains why the field is disabled. With isDisabled, the message shows in a tooltip on hover or keyboard focus and the input stays focusable with aria-disabled; the value still cannot change. |
isLoading | boolean | false | The field cannot be edited and shows a spinner. |
loadingLabel | string | Loading / 加载中 | Screen-reader text for the spinner. |
labelTooltip | string | — | Hint shown from the info icon at the end of the label. |
placeholder | string | Select a time | Empty-state text. While the field is focused and empty, a format hint replaces it. |