@xwink/ui

    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

    名称类型默认值说明
    minstring | undefinedundefined—
    maxstring | undefinedundefined—
    disabledboolean | undefinedfalse—
    readonlyboolean | undefinedfalse—
    ariaLabelstring | undefinedundefined—
    size"mini" | "small" | "medium" | "large" | "super" | undefinedundefined尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size
    variantFieldVariant | undefinedundefined—
    modelValuestring | undefined——

    Emits

    事件载荷说明
    update:modelValue[value: string | undefined]—

    XTimeField

    Props

    名称类型默认值说明
    granularityTimeGranularity | undefined"minute"精确到哪一位,缺省 minute(`09:30`)
    hourCycle12 | 24 | undefinedundefined12 或 24 小时制,缺省跟语言(zh-CN 是 24)
    minstring | undefinedundefined`09:00` 这类,两端都含
    maxstring | undefinedundefined—
    disabledboolean | undefinedfalse—
    readonlyboolean | undefinedfalse—
    ariaLabelstring | undefinedundefined—
    size"mini" | "small" | "medium" | "large" | "super" | undefinedundefined尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size
    variantFieldVariant | undefinedundefined—
    modelValuestring | undefined——

    Emits

    事件载荷说明
    update:modelValue[value: string | undefined]—