Zum Inhalt springen
Dokumentation

Komponenten

Schieberegler (Slider)

Stabil

Einen 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 %
Beispiel und Quelltext
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
Beispiel und Quelltext
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 slider und meldet seinen Wert über aria-valuenow. Ein einzelner Wert ergibt einen Griff, ein Bereich zwei – das ist im Komponententest abgesichert.
  • Tab fokussiert den Griff, die Pfeiltasten ändern den Wert um die Schrittweite. Das ist im Komponententest abgesichert.
  • Ein einzelner Griff übernimmt aria-label oder aria-labelledby von der Wurzel. Bei zwei Griffen braucht jeder Griff einen eigenen Namen über thumbLabels.
  • Ein gesperrter Regler ist nicht fokussierbar und ändert den Wert nicht.
  • Der Fokusring liegt auf den Griffen und ist über focus-visible sichtbar; die Komponente ist in hell und dunkel frei von axe-Verstößen.

Props

Props von Slider
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
defaultValuenumber[]–Nein–
disabledboolean–Nein–
onValueChange((value: number[]) => void)–Nein–
thumbLabelsstring[]–NeinAccessible names for the thumbs, in order. Range sliders need one per thumb.
valuenumber[]–Nein–

Siehe auch