rc-slider

What is rc-slider?

The rc-slider npm package is a React component that allows users to implement slider functionality in their web applications. It provides a range of sliders, including basic sliders, range sliders, and sliders with custom handles and tracks. It is customizable and supports various configurations such as vertical orientation, marks, step adjustments, and more.

What are rc-slider's main functionalities?

Basic Slider

This code sample demonstrates how to create a basic horizontal slider with a default value set to 30.

import React from 'react';
import Slider from 'rc-slider';
import 'rc-slider/assets/index.css';

const BasicSlider = () => (
  <Slider defaultValue={30} />
);

export default BasicSlider;

Range Slider

This code sample shows how to create a range slider that allows users to select a value range. The default selected range is from 20 to 50.

import React from 'react';
import { Range } from 'rc-slider';
import 'rc-slider/assets/index.css';

const RangeSlider = () => (
  <Range defaultValue={[20, 50]} />
);

export default RangeSlider;

Slider with Marks

This code sample illustrates a slider with marks at specified values. It also shows how to style individual marks and use React components as labels.

import React from 'react';
import Slider from 'rc-slider';
import 'rc-slider/assets/index.css';

const marks = {
  0: '0°C',
  26: '26°C',
  37: '37°C',
  100: {
    style: {
      color: 'red',
    },
    label: <strong>100°C</strong>,
  },
};

const MarkedSlider = () => (
  <Slider marks={marks} defaultValue={37} step={null} />
);

export default MarkedSlider;

Vertical Slider

This code sample demonstrates how to create a vertical slider by setting the 'vertical' prop. The slider is contained within a div that specifies its height.

import React from 'react';
import Slider from 'rc-slider';
import 'rc-slider/assets/index.css';

const VerticalSlider = () => (
  <div style={{ height: 200, marginLeft: 50 }}>
    <Slider vertical defaultValue={30} />
  </div>
);

export default VerticalSlider;

Other packages similar to rc-slider

react-slider

react-slider is another React component for creating sliders. It is similar to rc-slider but offers a different API and additional features like multiple thumbs on a single track, which can be useful for building more complex sliders.

react-rangeslider

react-rangeslider is a lightweight React component that provides a slider with a single handle. It is less feature-rich compared to rc-slider, focusing on simplicity and ease of use.

react-input-slider

react-input-slider is a React component that allows for slider input. It is similar to rc-slider but has a simpler API and fewer customization options, making it a good choice for straightforward slider implementations.

README

rc-slider

---

Slider UI component for React

Screenshots

Features

• Supports IE9, IE9+, Chrome, Firefox & Safari

Install

npm install --save rc-slider

Usage

import React from 'react';
import ReactDOM from 'react-dom';
import Slider, { Range } from 'rc-slider';
// We can just import Slider or Range to reduce bundle size
// import Slider from 'rc-slider/lib/Slider';
// import Range from 'rc-slider/lib/Range';
import 'rc-slider/assets/index.css';

ReactDOM.render(
  <div>
    <Slider />
    <Range />
  </div>,
  container
);

API

createSliderWithTooltip(Slider | Range) => React.Component

An extension to make Slider or Range support Tooltip on handle.

const Slider = require('rc-slider');
const createSliderWithTooltip = Slider.createSliderWithTooltip;
const Range = createSliderWithTooltip(Slider.Range);

Online demo

After Range or Slider was wrapped by createSliderWithTooltip, it will have the following props:

Name	Type	Default	Description
tipFormatter	(value: number): React.ReactNode	value => value	A function to format tooltip's overlay
tipProps	Object	{ placement: 'top', prefixCls: 'rc-slider-tooltip', overlay: tipFormatter(value) }	A function to format tooltip's overlay

Common API

The following APIs are shared by Slider and Range.

Name	Type	Default	Description
className	string	''	Additional CSS class for the root DOM node
min	number	0	The minimum value of the slider
max	number	100	The maximum value of the slider
marks	{number: string} or{number: { style, label }}	{}	Marks on the slider. The key determines the position, and the value determines what will show. If you want to set the style of a specific mark point, the value should be an object which contains style and label properties.
step	number or null	1	Value to be added or subtracted on each step the slider makes. Must be greater than zero, and max - min should be evenly divisible by the step value. When marks is not an empty object, step can be set to null, to make marks as steps.
vertical	boolean	false	If vertical is true, the slider will be vertical.
handle	(props) => React.ReactNode		A handle generator which could be used to customized handle.
included	boolean	true	If the value is true, it means a continuous value interval, otherwise, it is a independent value.
disabled	boolean	false	If true, handles can't be moved.
dots	boolean	false	When the step value is greater than 1, you can set the dots to true if you want to render the slider with dots.
onBeforeChange	Function	NOOP	onBeforeChange will be triggered when ontouchstart or onmousedown is triggered.
onChange	Function	NOOP	onChange will be triggered while the value of Slider changing.
onAfterChange	Function	NOOP	onAfterChange will be triggered when ontouchend or onmouseup is triggered.
minimumTrackStyle	Object		please use trackStyle instead. (only used for slider, just for compatibility , will be deprecate at rc-slider@9.x )
maximumTrackStyle	Object		please use railStyle instead (only used for slider, just for compatibility , will be deprecate at rc-slider@9.x)
handleStyle	Array[Object] | Object	[{}]	The style used for handle. (both for slider(Object) and range(Array of Object), the array will be used for mutli handle follow element order)
trackStyle	Array[Object] | Object	[{}]	The style used for track. (both for slider(Object) and range(Array of Object), the array will be used for mutli track follow element order)
railStyle	Object	{}	The style used for the track base color.
dotStyle	Object	{}	The style used for the dots.
activeDotStyle	Object	{}	The style used for the active dots.

Slider

Name	Type	Default	Description
defaultValue	number	0	Set initial value of slider.
value	number	-	Set current value of slider.
tabIndex	number	0	Set the tabIndex of the slider handle.

Range

Name	Type	Default	Description
defaultValue	number[]	[0, 0]	Set initial positions of handles.
value	number[]		Set current positions of handles.
tabIndex	number[]	[0, 0]	Set the tabIndex of each handle.
count	number	1	Determine how many ranges to render, and multiple handles will be rendered (number + 1).
allowCross	boolean	true	allowCross could be set as true to allow those handles to cross.
pushable	boolean or number	false	pushable could be set as true to allow pushing of surrounding handles when moving an handle. When set to a number, the number will be the minimum ensured distance between handles. Example:

Development

npm install
npm start

Example

npm start and then go to http://localhost:8005/examples/

Online examples: http://react-component.github.io/slider/

Test Case

http://localhost:8005/tests/runner.html?coverage

Coverage

http://localhost:8005/node_modules/rc-server/node_modules/node-jscover/lib/front-end/jscoverage.html?w=http://localhost:8088/tests/runner.html?coverage

License

rc-slider is released under the MIT license.