0.0.9 • Published 6 years ago
@alicd/crui-range-picker-field v0.0.9
category: Components type: UI Views component: Form chinese: 日历区间选择器 english: RangePickerField
source: next-date-picker
输入或选择日期的控件。当用户需要输入一个日期，可以点击标准输入框，弹出日期面板进行选择。
API
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| size | 输入框尺寸可选值:'small', 'medium', 'large' | Enum | 'medium' |
| defaultVisibleMonth | 默认展示的起始月份签名:Function() => MomentObject返回值:{MomentObject} 返回包含指定月份的 moment 对象实例 | Function | - |
| value | 日期范围值数组 moment, moment | Array | - |
| defaultValue | 初始的日期范围值数组 moment, moment | Array | - |
| format | 日期格式 | String | 'YYYY-MM-DD' |
| showTime | 是否使用时间控件，支持传入 TimePicker 的属性 | 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 |
| label | 输入框内置标签 | ReactNode | - |
| state | 输入框状态可选值:'error', 'success' | Enum | - |
| disabled | 是否禁用 | Boolean | - |
| hasClear | 是否显示清空按钮 | Boolean | true |
| visible | 弹层显示状态 | Boolean | - |
| defaultVisible | 弹层默认是否显示 | Boolean | - |
| onVisibleChange | 弹层展示状态变化时的回调签名:Function(visible: Boolean, reason: String) => void参数:visible: {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 |
0.0.9
6 years ago