If you have technical questions, please create a support ticket in the DevExpress Support Center.
import React, { useCallback, useState } from 'react';
import RangeSlider, { Tooltip, Label, RangeSliderTypes } from 'devextreme-react/range-slider';
import NumberBox, { NumberBoxTypes } from 'devextreme-react/number-box';
const defaultValues = {
defaultMode: [20, 60],
labels: [35, 65],
tooltips: [15, 65],
withoutRangeHighlighting: [20, 80],
discreteStep: [20, 70],
disabled: [25, 75],
};
const startValueLabel = { 'aria-label': 'Start Value' };
const endValueLabel = { 'aria-label': 'End Value' };
function App() {
const [startValue, setStartValue] = useState(10);
const [endValue, setEndValue] = useState(90);
const onRangeChanged = useCallback((data: RangeSliderTypes.ValueChangedEvent) => {
setStartValue(data.start);
setEndValue(data.end);
}, [setStartValue, setEndValue]);
const onStartChanged = useCallback((data: NumberBoxTypes.ValueChangedEvent) => {
setStartValue(data.value);
}, [setStartValue]);
const onEndChanged = useCallback((data: NumberBoxTypes.ValueChangedEvent) => {
setEndValue(data.value);
}, [setEndValue]);
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">
<RangeSlider min={0} max={100} defaultValue={defaultValues.defaultMode} />
</div>
</div>
<div className="dx-field custom-height-slider">
<div className="dx-field-label">With labels</div>
<div className="dx-field-value">
<RangeSlider min={0} max={100} defaultValue={defaultValues.labels}>
<Label visible={true} format={format} position="top" />
</RangeSlider>
</div>
</div>
<div className="dx-field custom-height-slider">
<div className="dx-field-label">With tooltips</div>
<div className="dx-field-value">
<RangeSlider min={0} max={100} defaultValue={defaultValues.tooltips}>
<Tooltip enabled={true} format={format} showMode="always" position="bottom" />
</RangeSlider>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Without range highlighting</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.withoutRangeHighlighting}
showRange={false} />
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">With discrete step</div>
<div className="dx-field-value">
<RangeSlider min={0} max={100} defaultValue={defaultValues.discreteStep} step={10}>
<Tooltip enabled={true} />
</RangeSlider>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Disabled</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.disabled}
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">
<RangeSlider
min={0}
max={100}
start={startValue}
end={endValue}
onValueChanged={onRangeChanged} />
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">On handle release</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
start={startValue}
end={endValue}
valueChangeMode="onHandleRelease"
onValueChanged={onRangeChanged} />
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Start value</div>
<div className="dx-field-value">
<NumberBox
value={startValue}
min={0}
max={100}
showSpinButtons={true}
inputAttr={startValueLabel}
onValueChanged={onStartChanged} />
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">End value</div>
<div className="dx-field-value">
<NumberBox
value={endValue}
min={0}
max={100}
showSpinButtons={true}
inputAttr={endValueLabel}
onValueChanged={onEndChanged} />
</div>
</div>
</div>
</div>
);
}
function format(value) {
return `${value}%`;
}
export default App;
xxxxxxxxxx
import React, { useCallback, useState } from 'react';
import RangeSlider, { Tooltip, Label } from 'devextreme-react/range-slider';
import NumberBox from 'devextreme-react/number-box';
const defaultValues = {
defaultMode: [20, 60],
labels: [35, 65],
tooltips: [15, 65],
withoutRangeHighlighting: [20, 80],
discreteStep: [20, 70],
disabled: [25, 75],
};
const startValueLabel = { 'aria-label': 'Start Value' };
const endValueLabel = { 'aria-label': 'End Value' };
function App() {
const [startValue, setStartValue] = useState(10);
const [endValue, setEndValue] = useState(90);
const onRangeChanged = useCallback(
(data) => {
setStartValue(data.start);
setEndValue(data.end);
},
[setStartValue, setEndValue],
);
const onStartChanged = useCallback(
(data) => {
setStartValue(data.value);
},
[setStartValue],
);
const onEndChanged = useCallback(
(data) => {
setEndValue(data.value);
},
[setEndValue],
);
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">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.defaultMode}
/>
</div>
</div>
<div className="dx-field custom-height-slider">
<div className="dx-field-label">With labels</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.labels}
>
<Label
visible={true}
format={format}
position="top"
/>
</RangeSlider>
</div>
</div>
<div className="dx-field custom-height-slider">
<div className="dx-field-label">With tooltips</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.tooltips}
>
<Tooltip
enabled={true}
format={format}
showMode="always"
position="bottom"
/>
</RangeSlider>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Without range highlighting</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.withoutRangeHighlighting}
showRange={false}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">With discrete step</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.discreteStep}
step={10}
>
<Tooltip enabled={true} />
</RangeSlider>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Disabled</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
defaultValue={defaultValues.disabled}
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">
<RangeSlider
min={0}
max={100}
start={startValue}
end={endValue}
onValueChanged={onRangeChanged}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">On handle release</div>
<div className="dx-field-value">
<RangeSlider
min={0}
max={100}
start={startValue}
end={endValue}
valueChangeMode="onHandleRelease"
onValueChanged={onRangeChanged}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Start value</div>
<div className="dx-field-value">
<NumberBox
value={startValue}
min={0}
max={100}
showSpinButtons={true}
inputAttr={startValueLabel}
onValueChanged={onStartChanged}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">End value</div>
<div className="dx-field-value">
<NumberBox
value={endValue}
min={0}
max={100}
showSpinButtons={true}
inputAttr={endValueLabel}
onValueChanged={onEndChanged}
/>
</div>
</div>
</div>
</div>
);
}
function format(value) {
return `${value}%`;
}
export default App;
xxxxxxxxxx
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
xxxxxxxxxx
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://unpkg.com/',
'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.1/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.54/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12',
'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/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.12/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
react: true,
},
};
System.config(window.config);
xxxxxxxxxx
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
xxxxxxxxxx
<html lang="en">
<head></head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
xxxxxxxxxx
.custom-height-slider {
height: 75px;
}
.dx-field > .dx-rangeslider {
flex: 1;
}
Create a RangeSlider
To create a RangeSlider, declare it in markup and specify the following four properties:
You can see the resulting RangeSlider in the Default mode section of this demo.
Customize RangeSlider Appearance
The RangeSlider can display labels for the min and max values. To configure the labels, use the label object. In this object, set the visible property to true
to display the labels. You can also specify the position and format properties.
The RangeSlider can also display a tooltip for slider handles. To display tooltips, you need to configure the tooltip object:
-
Set the enabled property to
true
to display tooltips. -
Specify the tooltip position.
-
Specify the format property.
-
Assign 'onHover' or 'always' to the showMode property to change how the component shows tooltips.
Use the showRange property to specify if the selected range should be highlighted. You can also use the step property to specify the value change step for the RangeSlider.
If you want to disable the RangeSlider, 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 components and the RangeSlider use this property to exchange values.
The valueChangeMode property allows you to choose when to change the RangeSlider value and supports the onHandleMove
and onHandleRelease
modes. You can see the property's effect in the Process Value Changes section. The first RangeSlider changes its value every time a user slides the handle. The second RangeSlider changes its value only when the handle is released. These RangeSlider values are synchronized.