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