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.
rc-slider
slider ui component for react
![Sauce Test Status](https://saucelabs.com/buildstatus/rc-slider)
![Sauce Test Status](https://saucelabs.com/browser-matrix/rc-slider.svg)
Screenshots
Feature
- support ie8,ie8+,chrome,firefox,safari
Keyboard
install
![rc-slider](https://nodei.co/npm/rc-slider.png)
Usage
var Rcslider = require('rc-slider');
var React = require('react');
React.render(<Rcslider />, container);
API
props
name | type | default | description |
---|
className | String | rc-slider | additional css class of root dom node |
min | number | 0 | The minimum value of the slider |
max | number | 100 | The maximum value of the slider |
step | number | 1 | Value to be added or subtracted on each step the slider makes. Must be greater than zero. max - min should be evenly divisible by the step value. |
defaultValue | number | 0 | Determines the initial positions of the handles. |
value | number | | Determines the current positions of the handles. |
marks | array | [] | mark every step for the slider, it will ignore the `step` parameter if it has been defined |
isIncluded | boolean | true | if the value is true, it means a continuous value interval, otherwise, it is a independent value. |
defaultIndex | number | 0 | For step or marks slider, determine the initial positions of the handles. |
index | number | | For step or marks slider, determine current positions of the handles. |
disabled | boolean | false | If true the handles can't be moved. |
Development
npm install
npm start
Example
http://localhost:8000/examples/
online example: http://react-component.github.io/slider/
Test Case
http://localhost:8000/tests/runner.html?coverage
Coverage
http://localhost:8000/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.