0.0.9 • Published 6 years ago
@alicd/crui-range-field v0.0.9
category: Components type: UI Views component: Form chinese: 区间选择器 english: RangeField
source: next-range
滑块控件(Sliders，简称滑块)可以让我们通过在连续或间断的区间内滑动锚点来选择一个合适的数值。区间最小值放在左边，对应的，最大值放在右边。滑块(Sliders)可以在滑动条的左右两端设定图标来反映数值的强度。这种交互特性使得它在设置诸如音量、亮度、色彩饱和度等需要反映强度等级的选项时成为一种极好的选择。
使用注意
onChange是和value进行配置做受控处理的。onChange在滑动过程中不会触发，滑动停止后会触发。 onProcess不建议内部做setState 进行受控，因为会频繁触发，整个滑动过程中会一直触发。
API
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| prefix | 样式类名的品牌前缀 | String | 'next-' |
| className | 自定义类名 | String | - |
| style | 自定义内敛样式 | Object | - |
| value | 设置当前取值。当 slider 为 single 时，使用 Number，否则用 [Number, Number] | Number/Array<Number> | - |
| defaultValue | 设置初始取值。当 slider 为 single 时，使用 Number，否则用 [Number, Number] | Number/Array<Number> | - |
| onChange | 当 Range 的值发生改变后，会触发 onChange 事件，并把改变后的值作为参数传入, 如果设置了value, 要配合此函数做受控使用签名:Function(value: String/number) => void参数:value: {String/number} null | Function | () => { } |
| slider | 滑块个数可选值:'single'(单个)'double'(两个) | Enum | 'single' |
| min | 最小值 | Number | 0 |
| max | 最大值 | Number | 100 |
| step | 步长，取值必须大于 0，并且可被 (max - min) 整除。 | Number | 1 |
| marks | 刻度数值显示逻辑（false 代表不显示，array 枚举显示的值，number 代表按 number 平分，object 表示按 key 划分，value 值显示） | Boolean/Number/Array<Number>/Object | false |
| disabled | 值为 true 时，滑块为禁用状态 | Boolean | false |
| onProcess | 滑块拖动的时候触发的事件,不建议在这里setState, 一般情况下不需要用, 滑动时有特殊需求时使用签名:Function(value: String/number) => void参数:value: {String/number} null | Function | () => { } |
| hasTip | 是否显示tip | Boolean | true |
| tipFormatter | tip文件自定义处理签名:Function() => void | Function | (value) => { return value; } |
| reverse | 选中态反转 | Boolean | false |
| 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