日期选择器 DatePicker
用于选择日期的组件,支持年、月、日三级联动选择。
何时使用
当需要用户输入一个日期时使用,支持多种交互状态和自定义配置。
示例
基础用法
最简单的用法,适用于大多数场景。
正在加载组件...
不同选择状态
展示日期选择器的不同选择状态。
正在加载组件...
加载状态
展示加载中的状态,可以有值或无值。
正在加载组件...
禁用状态
禁用日期选择器,用户无法进行操作。
正在加载组件...
Inflow 模式
使用 inflow 模式,容器会在下拉框打开时自动扩展。
正在加载组件...
自定义年份范围
可以自定义可选择的年份范围。
正在加载组件...
自定义标签
可以自定义年、月、日的标签文本。
正在加载组件...
API
DatePicker
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| value | 当前选中的值(受控模式) | { year?: number; month?: number; day?: number } | - |
| defaultValue | 默认选中的值(非受控模式) | { year?: number; month?: number; day?: number } | {} |
| disabled | 是否禁用 | boolean | false |
| loading | 是否加载中 | boolean | false |
| inflow | 是否使用 inflow 模式(撑开容器) | boolean | false |
| onChange | 选中值改变时的回调 | (value: { year?: number; month?: number; day?: number }) => void | - |
| className | 自定义类名 | string | - |
| onOpenChange | 下拉框展开/收起回调 | (open: boolean) => void | - |
| yearStart | 年份范围起始 | number | 2020 |
| yearEnd | 年份范围结束 | number | 2030 |
| yearLabel | 年标签 | string | '年' |
| monthLabel | 月标签 | string | '月' |
| dayLabel | 日标签 | string | '日' |
| monthLabels | 月份标签列表 | string[] | ['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月'] |