RangePicker
数据录入
@rockshin/tao-ui选择开始与结束日期,并可包含时间和快捷预设。
何时使用
筛选、报表或预订流程需要明确时间范围时使用 RangePicker。
推荐
- 提供常用范围预设。
- 清晰表达开始与结束顺序。
避免
- 只选单日时不要使用 RangePicker。
代码演示
基础用法
Start dateEnd date~
受控日期范围
Start dateEnd date~
预设与时间
Start dateEnd date~
Start dateEnd date~
范围选择与清除
依次选择开始和结束日期,维护范围值并提供清除入口。
Start dateEnd date~
Range: ? ~ ?
常用时间范围
为报表和筛选提供常用范围;预设值与用户手选范围使用同一值结构。
Start dateEnd date~
尺寸与外观
选择不同尺寸与 variant,匹配页面中的其他输入控件。
Start dateEnd date~
Start dateEnd date~
Start dateEnd date~
Start dateEnd date~
Start dateEnd date~
状态与禁用
error 与 warning 表达校验状态,disabled 用于不可编辑的值。
Start dateEnd date~
Start dateEnd date~
Start dateEnd date~
切换语言
通过 TaoProvider 的 locale 同步内置按钮、占位文字与日历标签。
Start dateEnd date~
限制日期范围
minDate 与 maxDate 同时限制输入和日历导航,示例固定为 2026 年以便复现。
Start dateEnd date~
受控值与清空
传入 value 控制范围,并在 onChange 中保存新值。应用需要重置范围时,将 value 设为 null。
两端均可编辑时,内置清空按钮会触发 onChange(null, ['', ''])。从 0.0.49 起,组件会直接丢弃正在编辑的文本,避免先把它作为已选范围发出。
Start dateEnd date~
自定义显示格式
format 控制显示文本,值仍是 Dayjs;不要将显示格式误认为存储格式。
Start dateEnd date~
日期与时间范围
showTime 增加两端的时间选择,确认后提交完整区间。
Start dateEnd date~
月份与年份范围
picker 选择月份或年份粒度。
Start dateEnd date~
Start dateEnd date~
仅禁用一端
元组形式的 disabled 可单独锁定开始或结束输入。
Start dateEnd date~
移动端抽屉标题按 mobileTitle → 最近的 Form.Item / FormField 的 label → 本地化默认文案取值。必填星号和帮助信息不会带入标题,placeholder 只用于输入提示。独立使用或搭配原生 HTML label 时,可显式设置 mobileTitle="出发日期"。
移动端选择
在手机预览中打开选择器,体验抽屉内的选择、确认和清空。