何时使用
滑块控件( Sliders,简称滑块)可以让我们通过在连续或间断的区间内滑动锚点来选择一个合适的数值。区间最小值放在左边,对应的,最大值放在右边。滑块( Sliders )可以在滑动条的左右两端设定图标来反映数值的强度。这种交互特性使得它在设置诸如音量、亮度、色彩饱和度等需要反映强度等级的选项时成为一种极好的选择。
使用注意
基本滑块,当 slider 为 double 时,渲染为双滑块。当 disabled 为 true 时,滑块处于不可用状态。
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
slider | 滑块个数 可选值: 'single'(单个) 'double'(两个) | Enum | 'single' |
min | 最小值 | Number | 0 |
max | 最大值 | Number | 100 |
step | 步长,取值必须大于 0,并且可被 (max - min) 整除。 | Number | 1 |
value | 设置当前取值。当 slider 为 single 时,使用 Number ,否则用 [Number, Number] | Number/Array<Number> | - |
defaultValue | 设置初始取值。当 slider 为 single 时,使用 Number ,否则用 [Number, Number] | Number/Array<Number> | - |
marks | 刻度数值显示逻辑(false 代表不显示,array 枚举显示的值,number 代表按 number 平分,object 表示按 key 划分,value 值显示) | Boolean/Number/Array<Number>/Object | false |
marksPosition | marks显示在上方('above')or下方('below') 可选值: 'above', 'below' | Enum | 'above' |
disabled | 值为 true 时,滑块为禁用状态 | Boolean | false |
onChange | 当 Range 的值发生改变后,会触发 onChange 事件,并把改变后的值作为参数传入, 如果设置了value, 要配合此函数做受控使用 签名: Function(value: String/number) => void 参数: value: {String/number} null | Function | func.noop |
onProcess | 滑块拖动的时候触发的事件,不建议在这里setState, 一般情况下不需要用, 滑动时有特殊需求时使用 签名: Function(value: String/number) => void 参数: value: {String/number} null | Function | func.noop |
hasTip | 是否显示 tip | Boolean | true |
tipRender | 自定义 tip 显示内容 签名: Function(value: Number/String) => ReactNode 参数: value: {Number/String} 值 返回值: {ReactNode} 显示内容 | Function | value => value |
reverse | 选中态反转 | Boolean | false |
pure | 是否pure render | Boolean | false |
fixedWidth | 是否为拖动线段类型,默认slider为double, defaultValue必传且指定区间 | Boolean | false |
tooltipVisible | tooltip是否默认展示 | Boolean | false |
rtl | 是否已rtl模式展示 | Boolean | false |
isPreview | 是否为预览态 | Boolean | false |
renderPreview | 预览态模式下渲染的内容 签名: Function(value: number) => void 参数: value: {number} 评分值 | Function | - |
通过 scales 与 marks 属性设置刻度及标识。
可以通过 min 与 max 设置范围边界。通过 step(被 max - min 整除) 设置移动的最小步频。min默认为0,max默认为100.
onChange , onProcess 事件
与 number-picker 结合,外部控制,与 Icon 结合设置边界 Icon
tipRender 示例
设置reverse为true, 选中态会反转。