category: Components
type: UI Views
component: Form
chinese: 日期选择框
english: DatePickerField
source: next-date-picker
输入或选择日期的控件。当用户需要输入一个日期，可以点击标准输入框，弹出日期面板进行选择。
API
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| size | 输入框尺寸 可选值: 'small', 'medium', 'large' |
Enum | 'medium' |
| state | 输入框状态 可选值: 'success', 'error' |
Enum | - |
| defaultVisibleMonth | 默认展现的月 签名: Function() => MomentObject 返回值: {MomentObject} 返回包含指定月份的 moment 对象实例 |
Function | - |
| value | 日期值（受控）moment 对象 | custom | - |
| defaultValue | 初始日期值，moment 对象 | custom | - |
| format | 日期值的格式（用于限定用户输入和展示） | String | 'YYYY-MM-DD' |
| showTime | 是否使用时间控件，传入 TimePicker 的属性 { defaultValue, format, ... } | Object/Boolean | false |
| resetTime | 每次选择日期时是否重置时间（仅在 showTime 开启时有效） | Boolean | false |
| disabledDate | 禁用日期函数 签名: Function(日期值: MomentObject) => Boolean 参数: 日期值: {MomentObject} null 返回值: {Boolean} 是否禁用 |
Function | () => false |
| footerRender | 自定义面板页脚 签名: Function() => Node 返回值: {Node} 自定义的面板页脚组件 |
Function | () => null |
| onChange | 日期值改变时的回调 签名: Function() => MomentObject/String 返回值: {MomentObject/String} 日期值 |
Function | func.noop |
| onOk | 点击确认按钮时的回调 签名: Function() => MomentObject/String 返回值: {MomentObject/String} 日期值 |
Function | func.noop |
| disabled | 是否禁用 | Boolean | - |
| hasClear | 是否显示清空按钮 | Boolean | true |
| open | 弹层显示状态 | Boolean | - |
| defaultOpen | 弹层默认是否显示 | Boolean | - |
| onOpenChange | 弹层展示状态变化时的回调 签名: Function(open: Boolean, reason: String) => void 参数: open: {Boolean} 弹层是否显示 reason: {String} 触发弹层显示和隐藏的来源 |
Function | func.noop |
| popupTriggerType | 弹层触发方式 可选值: 'click', 'hover' |
Enum | 'click' |
| popupAlign | 弹层对齐方式 | String | 'tl tl' |
| popupContainer | 弹层容器 签名: Function(target: Element) => Element 参数: target: {Element} 目标元素 返回值: {Element} 弹层的容器元素 |
Function | - |
| popupStyle | 弹层自定义样式 | Object | - |
| popupClassName | 弹层自定义样式类 | String | - |
| popupProps | 弹层其他属性 | Object | - |
| label | label 标签的文本 | ReactNode | - |
| labelCol | label 标签布局，通 <Col> 组件，设置 span offset 值，如 {span: 8, offset: 16}，该项仅在垂直表单有效 |
Object | - |
| help | 提示信息，如不设置，则会根据校验规则自动生成. 如果设置会受控（ps: 可以利用这点自定义错误位置,详细看demo自定义错误) | ReactNode | - |
| validateStatus | 校验状态，如不设置，则会根据校验规则自动生成可选值:'''success'(成功)'error'(失败)'loading'(校验中) | Enum | - |
| hasFeedback | 配合 validateStatus 属性使用，是否展示校验状态图标, 目前只有Input支持 | Boolean | false |
| wrapperCol | 需要为输入控件设置布局样式时，使用该属性，用法同 labelCol | Object | - |
| extra | 额外的提示信息，和 help 类似，当需要错误信息和提示文案同时出现时，可以使用这个。 位于错误信息后面 | ReactNode | - |
| inputStyle | 表单输入框自定义内联样式 | Object/String | null |
| showValidateType | 应用于Field 类元素后，指定其展示错误的方式，可选值有 help、tooltip 两种 |
String | help |
| name |
walle 模式下才支持 可以配合表单Form 收集表单元素的数据，要求表单必须指定 field 属性 |
String | '' |
| rules |
walle 模式下才支持 配置表单规则，可以配置多个规则，可参考：async-validator，注意Form 表单必须配置field 属性才会生效 |
Array | null |
| x-bind |
walle 模式下才支持 双向绑定某一个变量 |
state | null |