DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

React Slider

This demo shows how you can create and configure a Slider.

DevExtreme Accessibility Compliance
DevExtreme component libraries meet a variety of WCAG and Section 508 compliance standards. To assess this demo’s accessibility level, click the Run AXE® Validation button to launch the AXE® web accessibility evaluation tool.
All trademarks or registered trademarks are property of their respective owners. AXE® Terms of Use
The overall accessibility level of your application depends on the Slider features used.
Backend API
import React, { useCallback, useState } from 'react'; import { Slider, Label, Tooltip } from 'devextreme-react/slider'; import { NumberBox } from 'devextreme-react/number-box'; const sliderValueLabel = { 'aria-label': 'Slider Value' }; const format = (value) => `${value}%`; function App() { const [sliderValue, setSliderValue] = useState(10); const onValueChanged = useCallback((e: { value?: any; }) => { setSliderValue(e.value); }, [setSliderValue]); return ( <div className="form"> <div className="dx-fieldset"> <div className="dx-field"> <div className="dx-field-label">Default mode</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={90} /> </div> </div> <div className="dx-field custom-height-slider"> <div className="dx-field-label">With labels</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={50}> <Label visible={true} position="top" format={format} /> </Slider> </div> </div> <div className="dx-field custom-height-slider"> <div className="dx-field-label">With tooltip</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={35}> <Tooltip enabled={true} showMode="always" position="bottom" format={format} /> </Slider> </div> </div> <div className="dx-field"> <div className="dx-field-label">Without range highlighting</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={20} showRange={false} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">With discrete step</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={10} step={10}> <Tooltip enabled={true} /> </Slider> </div> </div> <div className="dx-field"> <div className="dx-field-label">Disabled</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={50} disabled={true} /> </div> </div> </div> <div className="dx-fieldset"> <div className="dx-fieldset-header">Process Value Changes</div> <div className="dx-field"> <div className="dx-field-label">On handle movement</div> <div className="dx-field-value"> <Slider min={0} max={100} value={sliderValue} onValueChanged={onValueChanged} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">On handle release</div> <div className="dx-field-value"> <Slider min={0} max={100} value={sliderValue} valueChangeMode="onHandleRelease" onValueChanged={onValueChanged} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Slider value</div> <div className="dx-field-value"> <NumberBox min={0} max={100} value={sliderValue} showSpinButtons={true} inputAttr={sliderValueLabel} onValueChanged={onValueChanged} /> </div> </div> </div> </div> ); } export default App;
import React, { useCallback, useState } from 'react'; import { Slider, Label, Tooltip } from 'devextreme-react/slider'; import { NumberBox } from 'devextreme-react/number-box'; const sliderValueLabel = { 'aria-label': 'Slider Value' }; const format = (value) => `${value}%`; function App() { const [sliderValue, setSliderValue] = useState(10); const onValueChanged = useCallback( (e) => { setSliderValue(e.value); }, [setSliderValue], ); return ( <div className="form"> <div className="dx-fieldset"> <div className="dx-field"> <div className="dx-field-label">Default mode</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={90} /> </div> </div> <div className="dx-field custom-height-slider"> <div className="dx-field-label">With labels</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={50} > <Label visible={true} position="top" format={format} /> </Slider> </div> </div> <div className="dx-field custom-height-slider"> <div className="dx-field-label">With tooltip</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={35} > <Tooltip enabled={true} showMode="always" position="bottom" format={format} /> </Slider> </div> </div> <div className="dx-field"> <div className="dx-field-label">Without range highlighting</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={20} showRange={false} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">With discrete step</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={10} step={10} > <Tooltip enabled={true} /> </Slider> </div> </div> <div className="dx-field"> <div className="dx-field-label">Disabled</div> <div className="dx-field-value"> <Slider min={0} max={100} defaultValue={50} disabled={true} /> </div> </div> </div> <div className="dx-fieldset"> <div className="dx-fieldset-header">Process Value Changes</div> <div className="dx-field"> <div className="dx-field-label">On handle movement</div> <div className="dx-field-value"> <Slider min={0} max={100} value={sliderValue} onValueChanged={onValueChanged} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">On handle release</div> <div className="dx-field-value"> <Slider min={0} max={100} value={sliderValue} valueChangeMode="onHandleRelease" onValueChanged={onValueChanged} /> </div> </div> <div className="dx-field"> <div className="dx-field-label">Slider value</div> <div className="dx-field-value"> <NumberBox min={0} max={100} value={sliderValue} showSpinButtons={true} inputAttr={sliderValueLabel} onValueChanged={onValueChanged} /> </div> </div> </div> </div> ); } export default App;
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@24.1.6/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.6/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.11/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.13/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.6/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>
.custom-height-slider { height: 75px; } .dx-field .dx-slider { flex: 1; }

Create a Slider

To create a Slider, declare it in markup and use the min and max properties to limit the range of accepted values.

You can also specify the value property to change the initial value.

The Default mode section shows a Slider with such a basic setup.

Customize Slider Appearance

Max and min labels

The Slider can display labels for the min and max values. To configure the labels, use the label object. In this object, specify the visible, position, and format properties.

Tooltip

To display a handle tooltip, you need to configure the tooltip object:

  • Set the enabled property to true to display a tooltip.

  • Specify the tooltip position: over or under the Slider.

  • Specify the format property.

  • Assign 'onHover' or 'always' to the showMode property to change how the component shows a tooltip.

Range highlight

Use the showRange property to specify if the component should highlight the range between min and value.

Discrete step

Use the step property to specify the value change step for the Slider.

Disabled state

If you want to disable the Slider, set the disabled property to true.

Handle the Value Change Event

Specify the onValueChanged function to handle the value change. In this demo, the NumberBox component and the Sliders exchange values through the variable bound to all the components. The state of this variable changes in the onValueChanged function.

The valueChangeMode property allows you to choose when the Slider changes its value. Available modes include onHandleMove and onHandleRelease. You can see the property's effect in the Process Value Changes section. The first Slider changes its value while a user slides the handle. The second Slider changes its value only after the user releases the handle. These Slider values are synchronized.