2.0.2 • Published 2 years ago

react-native-sliders v2.0.2

Weekly downloads
114
License
MIT
Repository
github
Last release
2 years ago

react-native-sliders

npm version npm downloads npm licence Platform

A pure JavaScript <Slider> component for react-native with multiple thumbs support.

It is a drop-in replacement for Slider.

Install

npm i --save react-native-sliders

Usage

import React from "react";
import Slider from "react-native-sliders";
import { AppRegistry, StyleSheet, View, Text } from "react-native";

class SliderExample extends React.Component {
  state = {
    value: [0.2, 0.5]
  };

  render() {
    return (
      <View style={styles.container}>
        <Slider
          value={this.state.value}
          onValueChange={value => this.setState({ value })}
        />
        <Text>
          Value: {this.state.value}
        </Text>
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    marginLeft: 10,
    marginRight: 10,
    alignItems: "stretch",
    justifyContent: "center"
  }
});

AppRegistry.registerComponent("SliderExample", () => SliderExample);

Try this example live on Expo Snack.

Props

PropTypeOptionalDefaultDescription
valuenumberYes0Initial value of the slider
disabledboolYesfalseIf true the user won't be able to move the slider
minimumValuenumberYes0Initial minimum value of the slider
maximumValuenumberYes1Initial maximum value of the slider
stepnumberYes0Step value of the slider. The value should be between 0 and maximumValue - minimumValue)
minimumTrackTintColorstringYes'#3f3f3f'The color used for the track to the left of the button
maximumTrackTintColorstringYes'#b3b3b3'The color used for the track to the right of the button
minimumTrackStylestyleYesThe style applied to the track to the left of the button
maximumTrackStylestyleYesThe style applied to the track to the right of the button
thumbStylestyleYesThe style applied to the thumb
thumbTintColorstringYes'#343434'The color used for the thumb
thumbTouchSizeobjectYes{width: 40, height: 40}The size of the touch area that allows moving the thumb. The touch area has the same center as the visible thumb. This allows to have a visually small thumb while still allowing the user to move it easily.
onValueChangefunctionYesCallback continuously called while the user is dragging the slider
onSlidingStartfunctionYesCallback called when the user starts changing the value (e.g. when the slider is pressed)
onSlidingCompletefunctionYesCallback called when the user finishes changing the value (e.g. when the slider is released)
stylestyleYesThe style applied to the slider container
trackStylestyleYesThe style applied to the track
thumbStylestyleYesThe style applied to the thumb
thumbElementReactNativeElementYesSets an element for the thumb.
debugTouchAreaboolYesfalseSet this to true to visually see the thumb touch rect in green.
animateTransitionsboolYesfalseSet to true if you want to use the default 'spring' animation
animationTypestringYes'timing'Set to 'spring' or 'timing' to use one of those two types of animations with the default animation properties.
animationConfigobjectYesundefinedUsed to configure the animation parameters. These are the same parameters in the Animated library.

MIT Licensed