@alicd/crui-number-picker-field
v0.0.6
Published
数字选择器,并对输入的数据做正确性检查、自动订正。
Downloads
22
Readme
category: Components type: UI Views component: Form chinese: 数字输入框 english: NumberPickerField source: next-number-picker
数字选择器,并对输入的数据做正确性检查、自动订正。
注意事项
- 自动订正可能会导致onChange返回值和你输入的数据不一样。
- 其中有些中间输入状态无法触发onChange,主要考虑到自动订正可能永远无法到达想要的值了。例如:
- 0=>0.=>0.0=>0.01 中间两步不会触发onChange,因为如果订正会一直停留在0导致永远无法到达想要的值 min=10 的情况下, 输入 1=>12 第一步 1 不会触发onChange也不会订正数据,因为数字是一个一个输入的 如果输入时没触发onChange,会在onBlur检测数据正确性并触发onChange
API
| 参数 | 说明 | 类型 | 默认值 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------- |
| prefix | 样式前缀 | String | 'next-' |
| className | 自定义class | String | - |
| style | 自定义内联样式 | Object | {} |
| type | 设置类型可选值:'normal'(普通)'inline'(内联) | Enum | 'normal' |
| value | 当前值 | Number | - |
| defaultValue | 默认值 | Number | 0 |
| onChange | 数值被改变的事件签名:Function(value: Number, e: Event) => void参数:value: {Number} 数据e: {Event} DOM事件对象 | Function | function noop() { } |
| step | 步长 | Number/String | 1 |
| editable | 用户是否可以输入 | Boolean | true |
| inputWidth | 输入框的宽度 | Number/String | - |
| onKeyDown | 键盘按下签名:Function() => void | Function | function noop() { } |
| onFocus | 焦点获得签名:Function() => void | Function | function noop() { } |
| onBlur | 焦点失去签名:Function() => void | Function | function noop() { } |
| onDisabled | 按钮被禁用时候点击的回调签名:Function(e: Event) => void参数:e: {Event} DOM事件对象 | Function | function noop() { } |
| onCorrect | 数值订正后的回调签名:Function(obj: Object) => void参数:obj: {Object} {currentValue,oldValue:String} | Function | function noop() { } |
| max | 最大值 | Number | Infinity |
| min | 最小值 | Number | -Infinity |
| 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 |