Getting Started with React Slider Component
Smart UI React targets React 18+ and current Node LTS for tooling; use TypeScript templates when you want typed props and events.
Demo source (Smart UI repo): react/source/slider/basic/App.jsx
1 Create a Vite + React + TypeScript app
npm create vite@latest my-smart-app -- --template react-ts
cd my-smart-app
thennpm install
2 Install Smart UI for React
npm install smart-webcomponents-react
3 Import styles and render the component
Open src/App.tsx (or App.jsx if you chose JavaScript). The snippet below matches Smart UI React demos for this widget:
import 'smart-webcomponents-react/source/styles/smart.default.css';
import './App.css';
import React, { useRef } from "react";
import { Slider } from 'smart-webcomponents-react/slider';
const App = () => {
const horizontalSliderValue = useRef(null);
const verticalSliderValue = useRef(null);
const invertedHorizontalSliderValue = useRef(null);
const invertedVerticalSliderValue = useRef(null);
const handleHorizontalSliderChange = (event) => {
horizontalSliderValue.current.innerHTML = parseFloat(event.detail.value).toFixed(2);
};
const handleVerticalSliderChange = (event) => {
verticalSliderValue.current.innerHTML = parseFloat(event.detail.value).toFixed(2);
};
const handleInvertedHorizontalSliderChange = (event) => {
invertedHorizontalSliderValue.current.innerHTML = parseFloat(event.detail.value).toFixed(2);
};
const handleInvertedVerticalSliderChange = (event) => {
invertedVerticalSliderValue.current.innerHTML = parseFloat(event.detail.value).toFixed(2);
};
return (
<div>
<div className="container">
<div className="underlined">Horizontal slider</div>Value: <span ref={horizontalSliderValue} id="horizontalSliderValue">30.00</span>
<Slider id="horizontalSlider" showTooltip orientation="horizontal"
min="0" max="100" value="30" scalePosition="none" onChange={handleHorizontalSliderChange}></Slider>
<br />
<div className="underlined">Vertical slider</div>Value: <span ref={verticalSliderValue} id="verticalSliderValue">30.00</span>
<Slider id="verticalSlider" showTooltip tooltipPosition="far" orientation="vertical"
min="0" max="100" value="30" scalePosition="none" onChange={handleVerticalSliderChange}></Slider>
</div>
<div className="container">
<div className="underlined">Inverted horizontal slider</div>Value: <span ref={invertedHorizontalSliderValue} id="invertedHorizontalSliderValue">30.00</span>
<Slider id="invertedHorizontalSlider" showTooltip orientation="horizontal"
inverted min="0" max="100" value="30" scalePosition="none" onChange={handleInvertedHorizontalSliderChange}></Slider>
<br />
<div className="underlined">Inverted vertical slider</div>Value: <span ref={invertedVerticalSliderValue} id="invertedVerticalSliderValue">30.00</span>
<Slider id="invertedVerticalSlider" showTooltip tooltipPosition="far"
orientation="vertical" inverted min="0" max="100" value="30" scalePosition="none" onChange={handleInvertedVerticalSliderChange}></Slider>
</div>
</div>
);
};
export default App;
4 Run the dev server
npm run dev
Open the URL Vite prints (often http://localhost:5173/).
TypeScript Support
Types ship with smart-webcomponents-react. Import the component and prop types:
import type { Slider, SliderProps } from 'smart-webcomponents-react/slider';
The generated wrappers expose on* callbacks (for example onChange) whose arguments are standard DOM Event values unless the widget typings narrow them further.
Accessibility
The Slider component follows WAI-ARIA best practices:
- Keyboard navigation - Tab, Arrow keys, Enter, and Escape are supported
- ARIA roles - Appropriate roles and labels are applied automatically
- Focus management - Visible focus indicators for keyboard users
- Screen readers - State changes are announced to assistive technology
- High contrast - Supports Windows High Contrast Mode and forced colors
For custom labeling, set aria-label or aria-labelledby attributes on the component.
Supported stacks: Smart UI targets Angular 17+, React 18+, Vue 3+, Node 18 LTS, and evergreen browsers; pin exact package versions to your org policy.