Komponenten
Schieberegler (Slider)
StabilEinen Wert oder einen Bereich stufenlos einstellen – mit einem oder zwei Griffen.
Ein Schieberegler stellt einen Wert in einem festen Bereich ein. Der Bereich ist sichtbar, der genaue Wert steht daneben – etwa die Bettenbelegung in Prozent.
Wann verwenden
- Wenn ein Wert in einem bekannten Bereich liegt und ein grober Wert genügt, etwa die Auslastung einer Station.
- Wenn der Bereich selbst die Information trägt, etwa die belegten Betten zwischen zwei Grenzen.
- Wenn du den Wert zusätzlich als Zahl daneben anzeigst.
Wann nicht
- Für eine exakte Zahl, die eingetippt wird, ist ein Zahlenfeld die bessere Wahl.
- Für wenige feste Stufen nimm eine Optionsgruppe oder eine Auswahl.
- Für einen unbekannten oder offenen Bereich ohne Grenzen passt ein Eingabefeld besser.
Ein Wert
Der Wert liegt als Liste mit einem Eintrag vor. min und max begrenzen den
Bereich, step bestimmt die Schrittweite.
72 %
wertebereich.tsx
import * as React from "react";
import { Label, Slider } from "@neodin-eu/ui";
function Wertebereich() {
const [belegung, setBelegung] = React.useState([72]);
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<div className="flex items-center justify-between">
<Label id="belegung-label">Bettenbelegung</Label>
<span className="text-sm text-muted-foreground">{belegung[0]} %</span>
</div>
<Slider aria-labelledby="belegung-label" value={belegung} onValueChange={setBelegung} />
</div>
);
}Bereich
Zwei Griffe begrenzen einen Bereich. Jeder Griff braucht einen eigenen Namen –
dafür gibt es thumbLabels.
8–20
spanne.tsx
import * as React from "react";
import { Label, Slider } from "@neodin-eu/ui";
function Spanne() {
const [bereich, setBereich] = React.useState([8, 20]);
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<div className="flex items-center justify-between">
<Label id="bereich-label">Belegte Betten je Station</Label>
<span className="text-sm text-muted-foreground">
{bereich[0]}–{bereich[1]}
</span>
</div>
<Slider
thumbLabels={["Untere Grenze", "Obere Grenze"]}
value={bereich}
min={0}
max={40}
step={1}
onValueChange={setBereich}
/>
</div>
);
}Barrierefreiheit
- Jeder Griff hat die Rolle
sliderund meldet seinen Wert überaria-valuenow. Ein einzelner Wert ergibt einen Griff, ein Bereich zwei – das ist im Komponententest abgesichert. Tabfokussiert den Griff, die Pfeiltasten ändern den Wert um die Schrittweite. Das ist im Komponententest abgesichert.- Ein einzelner Griff übernimmt
aria-labeloderaria-labelledbyvon der Wurzel. Bei zwei Griffen braucht jeder Griff einen eigenen Namen überthumbLabels. - Ein gesperrter Regler ist nicht fokussierbar und ändert den Wert nicht.
- Der Fokusring liegt auf den Griffen und ist über
focus-visiblesichtbar; die Komponente ist in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| defaultValue | number[] | – | Nein | – |
| disabled | boolean | – | Nein | – |
| onValueChange | ((value: number[]) => void) | – | Nein | – |
| thumbLabels | string[] | – | Nein | Accessible names for the thumbs, in order. Range sliders need one per thumb. |
| value | number[] | – | Nein | – |