@xwink/ui

    Calendar

    常驻展开的日历，以及按月、按年选的两个变体。值一律是 ISO 字符串（2026-10-17、2026-10、2026）：后端 DTO、校验规则、URL 筛选参数都是字符串，不必学 DateValue。月份名与星期名按 useUiLocale() 的语言格式化，一周缺省从星期一起。

    选一天、范围与不可选日
    2026年10月
    28
    29
    30
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    1
    2
    3
    4
    5
    6
    7
    8
    Event Date, 2026年10月
    选中：2026-10-17
    2026年10月
    28
    29
    30
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    1
    2
    3
    4
    5
    6
    7
    8
    Event Date, 2026年10月
    • 方向键按天、上下键按周移动，PageUp / PageDown 翻月，Home / End 到周首尾；回车或空格选中。
    • min / max 是 ISO 日期，两端都含；isDateDisabled 单独禁掉某些日子，入参是 ISO 日期。
    • numberOfMonths 并排显示几个月；weekStartsOn 改一周的第一天（0 是星期日）。

    按月、按年

    XMonthPicker 选账期、月报（2026-10），XYearPicker 选年度（2026），都是 3×4 的格子，左右翻页。要放进表单框里弹出时，包一层 Popover。

    月份与年份
    2026年
    1月
    2月
    3月
    4月
    5月
    6月
    7月
    8月
    9月
    10月
    11月
    12月
    Month Picker, 2026年
    账期：2026-10
    2020年 - 2031年
    2020年
    2021年
    2022年
    2023年
    2024年
    2025年
    2026年
    2027年
    2028年
    2029年
    2030年
    2031年
    Year Picker, 2020年 - 2031年
    年度：2026

    API

    Props

    名称类型默认值说明
    numberOfMonthsnumber | undefined1并排显示几个月,缺省 1
    weekStartsOn0 | 1 | 5 | 2 | 3 | 4 | 6 | undefined1一周从星期几开始(0 是星期日),缺省 1:国内日历从星期一起
    minstring | undefinedundefined最早可选(`2026-01-01`)
    maxstring | undefinedundefined最晚可选
    isDateDisabled((date: string) => boolean) | undefinedundefined单独禁掉某些日子(周末、节假日),入参是 ISO 日期
    disabledboolean | undefinedfalse—
    readonlyboolean | undefinedfalse—
    modelValuestring | undefined——

    Emits

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

    XMonthPicker

    Props

    名称类型默认值说明
    minstring | undefinedundefined`2026-01` 这类,两端都含
    maxstring | undefinedundefined—
    disabledboolean | undefinedfalse—
    readonlyboolean | undefinedfalse—
    modelValuestring | undefined——

    Emits

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

    XYearPicker

    Props

    名称类型默认值说明
    minstring | undefinedundefined`2020` 这类,两端都含
    maxstring | undefinedundefined—
    yearsPerPagenumber | undefined12一页几年,缺省 12
    disabledboolean | undefinedfalse—
    readonlyboolean | undefinedfalse—
    modelValuestring | undefined——

    Emits

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