Components: SliderIOS

Note: SliderIOS is deprecated and will be removed in the future. Use the cross-platform Slider as a drop-in replacement with the same API.

An iOS-specific component used to select a single value from a range of values.

Props

View props...

disabled bool

If true the user won't be able to move the slider. Default value is false.

maximumTrackImage Image.propTypes.source

Assigns a maximum track image. Only static images are supported. The leftmost pixel of the image will be stretched to fill the track.

maximumTrackTintColor string

The color used for the track to the right of the button. Overrides the default blue gradient image.

maximumValue number

Initial maximum value of the slider. Default value is 1.

minimumTrackImage Image.propTypes.source

Assigns a minimum track image. Only static images are supported. The rightmost pixel of the image will be stretched to fill the track.

minimumTrackTintColor string

The color used for the track to the left of the button. Overrides the default blue gradient image.

minimumValue number

Initial minimum value of the slider. Default value is 0.

onSlidingComplete function

Callback called when the user finishes changing the value (e.g. when the slider is released).

onValueChange function

Callback continuously called while the user is dragging the slider.

step number

Step value of the slider. The value should be between 0 and (maximumValue - minimumValue). Default value is 0.

style View#style

Used to style and layout the Slider. See StyleSheet.js and ViewStylePropTypes.js for more info.

thumbImage Image.propTypes.source

Sets an image for the thumb. It only supports static images.

trackImage Image.propTypes.source

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.

value number

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, e.g. if you don't update the value, the component won't be reset to its initial value.

Examples

'use strict';

var React = require('react');
var ReactNative = require('react-native');
var {
  SliderIOS,
  Text,
  StyleSheet,
  View,
} = ReactNative;

var SliderExample = React.createClass({
  getInitialState() {
    return {
      value: 0,
    };
  },

  render() {
    return (
      <View>
        <Text style={styles.text} >
          {this.state.value}
        </Text>
        <SliderIOS
          {...this.props}
          onValueChange={(value) => this.setState({value: value})} />
      </View>
    );
  }
});

var styles = StyleSheet.create({
  slider: {
    height: 10,
    margin: 10,
  },
  text: {
    fontSize: 14,
    textAlign: 'center',
    fontWeight: '500',
    margin: 10,
  },
});

exports.title = '<SliderIOS>';
exports.displayName = 'SliderExample';
exports.description = 'Slider input for numeric values';
exports.examples = [
  {
    title: 'Default settings',
    render(): ReactElement<any> {
      return <SliderExample />;
    }
  },
  {
    title: 'minimumValue: -1, maximumValue: 2',
    render(): ReactElement<any> {
      return (
        <SliderExample
          minimumValue={-1}
          maximumValue={2}
        />
      );
    }
  },
  {
    title: 'step: 0.25',
    render(): ReactElement<any> {
      return <SliderExample step={0.25} />;
    }
  },
  {
    title: 'Custom min/max track tint color',
    render(): ReactElement<any> {
      return (
        <SliderExample
          minimumTrackTintColor={'red'}
          maximumTrackTintColor={'green'}
        />
      );
    }
  },
  {
    title: 'Custom thumb image',
    render(): ReactElement<any> {
      return <SliderExample thumbImage={require('./uie_thumb_big.png')} />;
    }
  },
  {
    title: 'Custom track image',
    render(): ReactElement<any> {
      return <SliderExample trackImage={require('./slider.png')} />;
    }
  },
  {
    title: 'Custom min/max track image',
    render(): ReactElement<any> {
      return (
        <SliderExample
          minimumTrackImage={require('./slider-left.png')}
          maximumTrackImage={require('./slider-right.png')}
        />
      );
    }
  },
];

Links: