Slider

A component for selecting a value from a range with customizable appearance and behavior.

Import

import { Slider } from '@akitectio/aki-ui'

Basic Usage

const [value, setValue] = useState(50)

<Slider 
  value={value} 
  onChange={setValue}
  min={0}
  max={100}
/>

Range Slider

const [rangeValue, setRangeValue] = useState([20, 80])

<Slider 
  value={rangeValue} 
  onChange={setRangeValue}
  min={0}
  max={100}
  range
/>

Custom Steps

<Slider 
  defaultValue={30} 
  min={0}
  max={100}
  step={10}
/>

<Slider 
  defaultValue={50} 
  min={0}
  max={100}
  step={25}
/>

API Reference

Slider Props

PropTypeDefaultDescription
valuenumber | number[]-Current value(s) of the slider
defaultValuenumber | number[]0Default value(s) of the slider
minnumber0Minimum value
maxnumber100Maximum value
stepnumber1Step size for value increments
rangebooleanfalseEnable range selection
disabledbooleanfalseDisable the slider
onChange(value) => void-Callback when value changes

Accessibility

  • ✅ Full keyboard navigation support (arrow keys, page up/down, home/end)
  • ✅ Screen reader compatible with proper ARIA attributes
  • ✅ Focus management and visual indicators
  • ✅ Value announcements for assistive technologies

ARIA Attributes

  • role="slider" - Identifies the slider control
  • aria-valuemin - Minimum allowed value
  • aria-valuemax - Maximum allowed value
  • aria-valuenow - Current value
  • aria-orientation - Orientation of the slider