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,
},
'openai': {
'esModule': true,
},
},
paths: {
'npm:': 'https://cdn.jsdelivr.net/npm/',
'bundles:': '../../../../bundles/',
'externals:': '../../../../bundles/externals/',
},
defaultExtension: 'js',
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.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/prop-types.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@3.4.4/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign',
'devextreme': 'npm:devextreme@link:../../packages/devextreme/artifacts/npm/devextreme/cjs',
'devextreme-react': 'npm:devextreme-react@link:../../packages/devextreme-react/npm/cjs',
'devextreme-quill': 'npm:devextreme-quill@1.7.6/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.24/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.64/dist/dx-gantt.js',
'inferno': 'npm:inferno@8.2.3/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@8.2.3/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate/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',
'@preact/signals-core': 'npm:@preact/signals-core@1.8.0/dist/signals-core.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-react/common': {
main: 'index.js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/common/core/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',
],
babelOptions: {
sourceMaps: false,
stage0: true,
react: true,
},
};
System.config(window.config);
// eslint-disable-next-line
const useTgzInCSB = ['openai'];
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/25.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://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/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
trueto 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.