Skip to content
Nana UI

Range

A range/slider component supporting single and dual-thumb selection, vertical orientation, stepped and continuous modes, tooltips, tick marks, and linked numeric inputs.

Terminal window
npm install @nana-tec/ui-components
import "@nana-tec/ui-components/range";
<nana-range label="Volume" min="0" max="100" value="50" style="min-width:16rem"></nana-range>

The variant attribute sets the track fill — default, filled, or gradient.

PropertyTypeDefaultDescription
valuestring'50'Current value. Single: "50". Dual: "25,75".
minnumber0Minimum value
maxnumber100Maximum value
stepnumber1Step increment (0 for continuous)
dualbooleanfalseEnable dual-thumb range selection
orientation'horizontal' | 'vertical''horizontal'Layout orientation
tooltip'none' | 'always' | 'drag''none'Tooltip display mode
ticksbooleanfalseShow tick marks at every step
showMinMaxbooleanfalseShow min/max labels
showInputbooleanfalseShow linked numeric input fields
variant'default' | 'filled' | 'gradient''default'Visual variant
size'xs' | 'sm' | 'md' | 'lg' | 'xl''md'Component size
disabledbooleanfalseDisable interaction
ariaLabelstring | nullnullAccessible label
EventTypeDescription
nana-changeCustomEventFired when value settles (detail.value — string or {min, max})
nana-inputCustomEventFired while dragging (detail.value)
SlotDescription
(default)Custom content (appears below the slider)
prefixContent before the slider
suffixContent after the slider
VariableDefaultDescription
--nana-range-track-heightTrack thickness (default: 6px)
--nana-range-thumb-sizeThumb diameter (default: 20px)
--nana-range-track-bgTrack background
--nana-range-fill-bgFill colour
--nana-range-thumb-bgThumb background
--nana-range-thumb-radiusThumb shape (default: 50%)
--nana-range-tooltip-bgTooltip background
--nana-range-tooltip-colorTooltip text colour
--nana-range-gradient-fromGradient start (variant=“gradient”)
--nana-range-gradient-toGradient end (variant=“gradient”)
PartDescription
baseThe root container
trackThe track element
fillThe active fill portion
thumbA draggable handle
tooltipThe value tooltip
  • Keyboard accessible
  • Screen-reader labels
  • Focus-visible states
  • ARIA roles and states
  • WCAG 2.2 AA contrast
Explore Range interactively Every state, prop, and edge case — with live controls — in Storybook.
View in Storybook