@alicd/crui-range-field

0.0.9 • Public • Published

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 设置当前取值。当 slidersingle 时,使用 Number,否则用 [Number, Number] Number/Array<Number> -
defaultValue 设置初始取值。当 slidersingle 时,使用 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 类元素后,指定其展示错误的方式,可选值有 helptooltip 两种 String help
name walle 模式下才支持 可以配合表单Form 收集表单元素的数据,要求表单必须指定 field 属性 String ''
rules walle 模式下才支持 配置表单规则,可以配置多个规则,可参考:async-validator,注意Form 表单必须配置field 属性才会生效 Array null
x-bind walle 模式下才支持 双向绑定某一个变量 state null

Readme

Keywords

Package Sidebar

Install

npm i @alicd/crui-range-field

Weekly Downloads

9

Version

0.0.9

License

ISC

Unpacked Size

869 kB

Total Files

27

Last publish

Collaborators

  • snowden_
  • vincent.ljq
  • zhen.hz
  • cismous
  • juntao.wjt
  • xiongqi
  • mingche_286130
  • joshuasui
  • mmpc
  • 0little
  • yf871020
  • zyy7259
  • later_7
  • qijian1990
  • gepik
  • jimmyxuster
  • helloljq
  • rentj1
  • js8zq332
  • xiaobc