English | 中文
Sliders allow users to select a value from a fixed set of options. It supports the following features:
horizontal
andvertical
two directionsone
ortwo
thumbs two modes- customized style for track and thumb
- friendly tooltip and fully customized tip formatter
npm install @rn-components-kit/slider --save
Preview | Code |
---|---|
![]() ![]() |
Demo1 Code |
![]() ![]() |
Demo2 Code |
![]() ![]() |
Demo3 Code |
![]() ![]() |
Demo4 Code |
style
min
max
step
defaultValue
multi
vertical
showTip
tipContainerStyle
tipTextStyle
trackColor
selectedTrackColor
thumbStyle
renderThumb
tipFormatter
onValueChange
onBeginSliding
onEndSliding
Allows you to customize style
Type | Required | Default |
---|---|---|
object | no | - |
The minimum value that thumb can slide to
Type | Required | Default |
---|---|---|
number | no | 0 |
The maximum value that thumb can slide to
Type | Required | Default |
---|---|---|
number | no | 100 |
The granularity the slider can step through values. (Must greater than 0, and be divided by (max - min)
)
Type | Required | Default |
---|---|---|
number | no | 1 |
The initial value when first render slider
Type | Required | Default |
---|---|---|
number | number[] | no | - |
Determines whether one or two thumbs in slider
Type | Required | Default |
---|---|---|
boolean | no | false |
Determines whether slider is horizontal or vertical
Type | Required | Default |
---|---|---|
boolean | no | false |
Determines whether tooltip is shown
Type | Required | Default |
---|---|---|
enum('never' , 'onTap' , 'always' ) |
no | false |
Allows you to customize tooltip's container style (e.g. size, backgroundColor)
Type | Required | Default |
---|---|---|
object | no | - |
Allows you to customize tooltip's text style (e.g. fontSize, color)
Type | Required | Default |
---|---|---|
object | no | - |
Color of track
Type | Required | Default |
---|---|---|
string | no | '#DDD' |
Color of track's selected part
Type | Required | Default |
---|---|---|
string | no | '#40A9FF' |
Allows you to customize thumb's style (e.g. color, size, shadow)
Type | Required | Default |
---|---|---|
object | no | - |
() => void
Allows you to fully customize thumb module
Type | Required | Default |
---|---|---|
function | no | - |
(value: number) => string
Slider will pass value to tipFormatter, and display its return value in tooltip
Type | Required | Default |
---|---|---|
function | no | value => value.toString() |
(value: number) => void
A callback will be triggered when slider's value changes
Type | Required | Default |
---|---|---|
function | no | () => {} |
() => void
A callback will be triggered when slider starts to slide
Type | Required | Default |
---|---|---|
function | no | () => {} |
() => void
A callback will be triggered when slider ends to slide
Type | Required | Default |
---|---|---|
function | no | () => {} |