Slider.
Find just the right amount of light.
Live preview
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
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.
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.
| Prop | Type | Details |
|---|---|---|
value | number | Optional unless marked required. |
defaultValue | number | Optional unless marked required. |
min | number | Optional unless marked required. |
max | number | Optional unless marked required. |
onChange | (value: number) => void | Optional unless marked required. |
label | string | Optional unless marked required. |
showValue | boolean | Optional unless marked required. |
formatValue | (value: number) => string | Optional unless marked required. |
glowColor | GlowColor | Optional 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
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.