Range 区段选择器

何时使用

滑块控件( Sliders,简称滑块)可以让我们通过在连续或间断的区间内滑动锚点来选择一个合适的数值。区间最小值放在左边,对应的,最大值放在右边。滑块( Sliders )可以在滑动条的左右两端设定图标来反映数值的强度。这种交互特性使得它在设置诸如音量、亮度、色彩饱和度等需要反映强度等级的选项时成为一种极好的选择。

使用注意

  • onChange 是和 value 进行配置做受控处理的。onChange 在滑动过程中不会触发,滑动停止后会触发。
  • onProcess 不建议内部做 setState 进行受控,因为会频繁触发,整个滑动过程中会一直触发。

基本

基本滑块,当 slider 为 double 时,渲染为双滑块。当 disabled 为 true 时,滑块处于不可用状态。

Loading demo...

APIs

Range

参数说明类型默认值
slider滑块个数

可选值:
'single'(单个)
'double'(两个)
Enum'single'
min最小值Number0
max最大值Number100
step步长,取值必须大于 0,并且可被 (max - min) 整除。Number1
value设置当前取值。当 slidersingle 时,使用 Number,否则用 [Number, Number]Number/Array<Number>-
defaultValue设置初始取值。当 slidersingle 时,使用 Number,否则用 [Number, Number]Number/Array<Number>-
marks刻度数值显示逻辑(false 代表不显示,array 枚举显示的值,number 代表按 number 平分,object 表示按 key 划分,value 值显示)Boolean/Number/Array<Number>/Objectfalse
marksPositionmarks显示在上方('above')or下方('below')

可选值:
'above', 'below'
Enum'above'
disabled值为 true 时,滑块为禁用状态Booleanfalse
onChange当 Range 的值发生改变后,会触发 onChange 事件,并把改变后的值作为参数传入, 如果设置了value, 要配合此函数做受控使用

签名:
Function(value: String/number) => void
参数:
value: {String/number} null
Functionfunc.noop
onProcess滑块拖动的时候触发的事件,不建议在这里setState, 一般情况下不需要用, 滑动时有特殊需求时使用

签名:
Function(value: String/number) => void
参数:
value: {String/number} null
Functionfunc.noop
hasTip是否显示 tipBooleantrue
tipRender自定义 tip 显示内容

签名:
Function(value: Number/String) => ReactNode
参数:
value: {Number/String} 值
返回值:
{ReactNode} 显示内容
Functionvalue => value
reverse选中态反转Booleanfalse
pure是否pure renderBooleanfalse
fixedWidth是否为拖动线段类型,默认slider为double, defaultValue必传且指定区间Booleanfalse
tooltipVisibletooltip是否默认展示Booleanfalse
rtl是否已rtl模式展示Booleanfalse
isPreview是否为预览态Booleanfalse
renderPreview预览态模式下渲染的内容

签名:
Function(value: number) => void
参数:
value: {number} 评分值
Function-

Demo

刻度及标识

Loading demo...

通过 scales 与 marks 属性设置刻度及标识。

min,max,step

Loading demo...

可以通过 min 与 max 设置范围边界。通过 step(被 max - min 整除) 设置移动的最小步频。min默认为0,max默认为100.

事件

Loading demo...

onChange , onProcess 事件

范围与step

Loading demo...

与 number-picker 结合,外部控制,与 Icon 结合设置边界 Icon

tipRender

Loading demo...

tipRender 示例

选择态反转

Loading demo...

设置reverse为true, 选中态会反转。