reactrangeslider

React Sliders

An collection of elegant slider components for React. Demo Page.

Installing

The library is available as npm package.

npm install reactrangeslider

Using The component

The component is easy to use. Import the library and add the component to your JSX:

import React from 'react';
import Slider from 'range-sliders';

const MyPage = () =>
  <div>
    <Slider />
  </div>;

An example of uncontrolled slider with single handle, defaultValue and step passed in props:

import React from 'react';
import RangeSlider from 'reactrangeslider';

const MyPage = () =>
  <div>
    <Slider defaultValue={20} step={ 5 } />
  </div>;

An example of controlled range slider with two handles, value and step passed in props:

import React from 'react';
import RangeSlider from 'reactrangeslider';

// value={ start: 20, end: 80 }
const MyPage = (value, onChange) =>
  <div>
    <RangeSlider
      value={ value }
      onChange={ onChange }
      min={ 20 }
      max={ 100 }
      step={ 5 }
    />
  </div>;

Check docs for more examples.

List of properties supported

Option	Description
id	id of the root div element
name	name of the root div element
min	minimum value in the range
max	maximum value in the range
step	amount by which the position of slider will change in one movement
defaultValue	it is used to initialize uncontrolled components
value	it is used to set value in a controlled component
onChange	the function is executed whenever the value changes
afterChange	the function is executed after the user has stopped moving the slider
disabled	property used to disable component, disable component can not even receive focus
readOnly	property used to make component readOnly, it can still be focused
tabIndex	this is used to set the tabIndex of handles which are moved to change value of slider

Custom styling

Styling of Range Slider is highly customizable. It supports styling using both inline styles and classes. Internally the libary used inline styles, I have preferred that for ease of installation for users.

If inline styles are used for styling, the inline styles passed to it will override the defaults. If classes are used for styling, you will be required to use !important to override corresponding default inline style.

Style Property	Description
wrapperStyle	style applied to wrapper div element
trackStyle	style applied to track
disabledTrackStyle	style applied to track of disabled component
highlightedTrackStyle	style applied to highlighted track
disabledHighlightedTrackStyle	style applied to highlighted track of disabled component
handleStyle	style applied to handle
focusedHandleStyle	style applied to focused handle
hoveredHandleStyle	style applied to hovered handle
activeHandleStyle	style applied to active handle
disabledHandleStyle	style applied to disabled handle

Class Name	Description
wrapperClassName	class applied to wrapper div element
handleClassName / disabledHandleClassName	either of these classes is applied to the handle depending on whether its enabled or disabled
trackClassName / highlightedTrackClassName	either of these classes is applied to the track depending on whether its enabled or disabled
highlightedTrackClassName / disabledHighlightedTrackClassName	either of these classes is applied to the highlighted handle depending on whether its enabled or disabled
Styles applied to highlighted track are applicable only to Reage Slider with two handles and highlighted area between them.

Device support

Range Slider is responsive to different sizes and resolutions. Its responsive to mouse, keyboard and touch events.

Future plans

Making it a complete range of slider components with addition of components like vertical slider, vertical range slider, etc motivation.

License

MIT.