Forms

Slider.

Find just the right amount of light.

Live preview

Live preview
64%
35
70
tsx
import { Slider } from "luminescent";
import "luminescent/style.css";


export function Example() {
  return (
    <Slider
      label="Light intensity"
      defaultValue={64}
      step={1}
      formatValue={(value) => `${value}%`}
      name="intensity"
    />
  );
}

Installation

bash
npm install luminescent

Import luminescent/style.css once at your application root. The example above uses the same package implementation as Storybook.

Variants and states

Use the preview controls to explore the supported variants, sizes, disabled/loading states and reduced motion. Controls appear only where the component exposes the corresponding prop. Theme and glow apply to every component.

Controlled and uncontrolled state

State contract: value / defaultValue / onChange (number). Omit the controlled prop to let the component own its initial state; supply a value and callback when your application owns it. Native uncontrolled fields and state-backed form controls participate in form reset. Controlled state must be reset by the application.

tsx
import { useState } from "react";
import { Slider } from "luminescent";


export function ControlledExample() {
  const [value, setValue] = useState(64);
  return <Slider label="Light intensity" value={value} onChange={setValue} />;
}

API reference

Generated from the source TypeScript interfaces. Native attributes, className, style, aria-* and data-* also pass through to the documented element. Import SliderProps from the package for the full inherited contract.

PropTypeDetails
valuenumberOptional unless marked required.
defaultValuenumberOptional unless marked required.
minnumberOptional unless marked required.
maxnumberOptional unless marked required.
onChange(value: number) => voidOptional unless marked required.
labelstringOptional unless marked required.
showValuebooleanOptional unless marked required.
formatValue(value: number) => stringOptional unless marked required.
glowColorGlowColorOptional unless marked required.

Accessibility and keyboard

Native range supports arrows, Home and End. Values are clamped and aligned to step; invalid/reversed bounds and nonfinite numbers normalize safely. React onChange receives a number. step="any" permits continuous values.

Keep labels meaningful and test application-level contrast, focus order and screen-reader output. See the accessibility guide for composition requirements.

Theme customization

tsx
import { LuminescentProvider, Slider } from "luminescent";
import "luminescent/style.css";


export function Example() {
  return (
    <LuminescentProvider theme="light" accent="violet" glow="subtle">
      <Slider
        label="Light intensity"
        defaultValue={64}
        step={1}
        formatValue={(value) => `${value}%`}
        name="intensity"
      />
    </LuminescentProvider>
  );
}

Switch between light and dark in the preview, or open the playground for a larger workspace. Custom CSS variables can override spacing, color, typography and effects.

Related components