For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/range-picker.md.
v0.0.57
  • 简体中文
  • RangePicker

    数据录入@rockshin/tao-ui

    选择开始与结束日期,并可包含时间和快捷预设。

    何时使用

    筛选、报表或预订流程需要明确时间范围时使用 RangePicker。

    推荐

    • 提供常用范围预设。
    • 清晰表达开始与结束顺序。

    避免

    • 只选单日时不要使用 RangePicker。

    代码演示

    基础用法

    ~
    TSX

    受控日期范围

    ~
    TSX

    预设与时间

    ~
    ~
    TSX

    范围选择与清除

    依次选择开始和结束日期,维护范围值并提供清除入口。

    ~

    Range: ? ~ ?

    TSX

    常用时间范围

    为报表和筛选提供常用范围;预设值与用户手选范围使用同一值结构。

    ~
    TSX

    尺寸与外观

    选择不同尺寸与 variant,匹配页面中的其他输入控件。

    ~
    ~
    ~
    ~
    ~
    TSX

    状态与禁用

    error 与 warning 表达校验状态,disabled 用于不可编辑的值。

    ~
    ~
    ~
    TSX

    切换语言

    通过 TaoProvider 的 locale 同步内置按钮、占位文字与日历标签。

    ~
    TSX

    限制日期范围

    minDate 与 maxDate 同时限制输入和日历导航,示例固定为 2026 年以便复现。

    ~
    TSX

    受控值与清空

    传入 value 控制范围,并在 onChange 中保存新值。应用需要重置范围时,将 value 设为 null。

    两端均可编辑时,内置清空按钮会触发 onChange(null, ['', ''])。从 0.0.49 起,组件会直接丢弃正在编辑的文本,避免先把它作为已选范围发出。

    ~
    No selection
    TSX

    自定义显示格式

    format 控制显示文本,值仍是 Dayjs;不要将显示格式误认为存储格式。

    ~
    TSX

    日期与时间范围

    showTime 增加两端的时间选择,确认后提交完整区间。

    ~
    TSX

    月份与年份范围

    picker 选择月份或年份粒度。

    ~
    ~
    TSX

    仅禁用一端

    元组形式的 disabled 可单独锁定开始或结束输入。

    ~
    TSX

    移动端抽屉标题按 mobileTitle → 最近的 Form.Item / FormField 的 label → 本地化默认文案取值。必填星号和帮助信息不会带入标题,placeholder 只用于输入提示。独立使用或搭配原生 HTML label 时,可显式设置 mobileTitle="出发日期"。

    移动端选择

    在手机预览中打开选择器,体验抽屉内的选择、确认和清空。

    390 × 640
    TSX

    API

    RangePicker

    属性说明类型默认值
    disabled是否禁用boolean | [boolean, boolean] | undefined-
    mobileTitleMobile drawer title. Defaults to the Form.Item/FormField label, then locale text.ReactNode-
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-