DateField
分段输入日期与时间:年、月、日(时、分、秒)各是一段,数字直接敲、上下键增减、左右键换段,段的顺序与分隔符按语言排好(zh-CN 是年/月/日)。适合生日这类明确知道值、不需要看日历的场景;要日历用 DatePicker。外观与 XInput 同一个壳。
日期与时间
年
/月
/日
值:(未填完)
09
:30
值:09:30
––
:––
:––
值:(空)
XDateField的v-model是 ISO 日期(2026-10-17),没填完是undefined;min/max同格式。XTimeField的v-model是09:30这样的字符串,精确到哪一位由granularity定(hour/minute缺省 /second);hourCycle改 12 或 24 小时制。
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
min | string | undefined | undefined | — |
max | string | undefined | undefined | — |
disabled | boolean | undefined | false | — |
readonly | boolean | undefined | false | — |
ariaLabel | string | undefined | undefined | — |
size | "mini" | "small" | "medium" | "large" | "super" | undefined | undefined | 尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size |
variant | FieldVariant | undefined | undefined | — |
modelValue | string | undefined | — | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: string | undefined] | — |
XTimeField
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
granularity | TimeGranularity | undefined | "minute" | 精确到哪一位,缺省 minute(`09:30`) |
hourCycle | 12 | 24 | undefined | undefined | 12 或 24 小时制,缺省跟语言(zh-CN 是 24) |
min | string | undefined | undefined | `09:00` 这类,两端都含 |
max | string | undefined | undefined | — |
disabled | boolean | undefined | false | — |
readonly | boolean | undefined | false | — |
ariaLabel | string | undefined | undefined | — |
size | "mini" | "small" | "medium" | "large" | "super" | undefined | undefined | 尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size |
variant | FieldVariant | undefined | undefined | — |
modelValue | string | undefined | — | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: string | undefined] | — |