Slider
A component used to select a single value from a range of values.
Props
styledisabledmaximumValueminimumTrackTintColorminimumValueonSlidingCompleteonValueChangestepmaximumTrackTintColortestIDvaluethumbTintColormaximumTrackImageminimumTrackImagethumbImagetrackImage
Reference
Props
style
Used to style and layout the Slider. See StyleSheet.js and ViewStylePropTypes.js for more info.
| Type | Required |
|---|---|
| View.style | No |
disabled
If true the user won't be able to move the slider. Default value is false.
| Type | Required |
|---|---|
| bool | No |
maximumValue
Initial maximum value of the slider. Default value is 1.
| Type | Required |
|---|---|
| number | No |
minimumTrackTintColor
The color used for the track to the left of the button. Overrides the default blue gradient image on iOS.
| Type | Required |
|---|---|
| color | No |
minimumValue
Initial minimum value of the slider. Default value is 0.
| Type | Required |
|---|---|
| number | No |
onSlidingComplete
Callback called when the user finishes changing the value (e.g. when the slider is released).
| Type | Required |
|---|---|
| function | No |
onValueChange
Callback continuously called while the user is dragging the slider.
| Type | Required |
|---|---|
| function | No |
step
Step value of the slider. The value should be between 0 and (maximumValue - minimumValue). Default value is 0.
| Type | Required |
|---|---|
| number | No |
maximumTrackTintColor
The color used for the track to the right of the button. Overrides the default blue gradient image on iOS.
| Type | Required |
|---|---|
| color | No |
testID
Used to locate this view in UI automation tests.
| Type | Required |
|---|---|
| string | No |
value
Initial value of the slider. The value should be between minimumValue and maximumValue, which default to 0 and 1 respectively. Default value is 0.
This is not a controlled component, you don't need to update the value during dragging.
| Type | Required |
|---|---|
| number | No |
thumbTintColor
Color of the foreground switch grip.
| Type | Required | Platform |
|---|---|---|
| color | No | Android |
maximumTrackImage
Assigns a maximum track image. Only static images are supported. The leftmost pixel of the image will be stretched to fill the track.
| Type | Required | Platform |
|---|---|---|
| Image.propTypes.source | No | iOS |
minimumTrackImage
Assigns a minimum track image. Only static images are supported. The rightmost pixel of the image will be stretched to fill the track.
| Type | Required | Platform |
|---|---|---|
| Image.propTypes.source | No | iOS |
thumbImage
Sets an image for the thumb. Only static images are supported.
| Type | Required | Platform |
|---|---|---|
| Image.propTypes.source | No | iOS |
trackImage
Assigns a single image for the track. Only static images are supported. The center pixel of the image will be stretched to fill the track.
| Type | Required | Platform |
|---|---|---|
| Image.propTypes.source | No | iOS |