日期选择器 DatePicker

用于选择日期的组件,支持年、月、日三级联动选择。

何时使用

当需要用户输入一个日期时使用,支持多种交互状态和自定义配置。

示例

基础用法

最简单的用法,适用于大多数场景。

正在加载组件...
code

不同选择状态

展示日期选择器的不同选择状态。

正在加载组件...
code

加载状态

展示加载中的状态,可以有值或无值。

正在加载组件...
code

禁用状态

禁用日期选择器,用户无法进行操作。

正在加载组件...
code

Inflow 模式

使用 inflow 模式,容器会在下拉框打开时自动扩展。

正在加载组件...
code

自定义年份范围

可以自定义可选择的年份范围。

正在加载组件...
code

自定义标签

可以自定义年、月、日的标签文本。

正在加载组件...
code

API

DatePicker

参数说明类型默认值
value当前选中的值(受控模式){ year?: number; month?: number; day?: number }-
defaultValue默认选中的值(非受控模式){ year?: number; month?: number; day?: number }{}
disabled是否禁用booleanfalse
loading是否加载中booleanfalse
inflow是否使用 inflow 模式(撑开容器)booleanfalse
onChange选中值改变时的回调(value: { year?: number; month?: number; day?: number }) => void-
className自定义类名string-
onOpenChange下拉框展开/收起回调(open: boolean) => void-
yearStart年份范围起始number2020
yearEnd年份范围结束number2030
yearLabel年标签string'年'
monthLabel月标签string'月'
dayLabel日标签string'日'
monthLabels月份标签列表string[]['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月']