Zum Inhalt springen
Dokumentation

Komponenten

Schalter (Switch)

Stabil

Eine Einstellung sofort ein- oder ausschalten – mit sichtbarem Zustand.

Ein Schalter stellt eine Einstellung ein oder aus, die sofort gilt: bei neuen Tickets benachrichtigen, Änderungen am Dienstplan melden. Der Zustand ist am Hebel erkennbar, ohne dass du ihn lesen musst.

Wann verwenden

  • Für Einstellungen mit genau zwei Zuständen, die direkt wirken.
  • In Einstellungsseiten und Konten, in denen du mehrere Optionen schnell umschaltest.
  • Wenn der Zustand auch nach dem Verlassen der Seite erhalten bleibt.

Wann nicht

  • Für einen Wert, der erst mit dem Formular abgeschickt wird, ist ein Kontrollkästchen die richtige Form.
  • Für eine Auswahl aus mehreren Möglichkeiten nimm eine Optionsgruppe oder eine Auswahl mit Klappliste.
  • Für eine Aktion, die ausgeführt wird, gehört eine Schaltfläche hin – ein Schalter hält einen Zustand, er löst keine einmalige Aktion aus.

Ein und aus

Beschriftung und Schalter stehen zusammen; die Beschriftung nennt die Einstellung, nicht den Zustand. Ein gesperrter Schalter bleibt sichtbar und zeigt weiter seinen Zustand.

Beispiel und Quelltext
einstellungen.tsx
import * as React from "react";

import { Label, Switch } from "@neodin-eu/ui";

function Einstellungen() {
  const [tickets, setTickets] = React.useState(true);
  const [dienstplan, setDienstplan] = React.useState(false);

  return (
    <div className="flex w-full max-w-sm flex-col gap-4">
      <div className="flex items-center justify-between gap-4">
        <Label htmlFor="neue-tickets">Bei neuen Tickets benachrichtigen</Label>
        <Switch id="neue-tickets" checked={tickets} onCheckedChange={setTickets} />
      </div>
      <div className="flex items-center justify-between gap-4">
        <Label htmlFor="dienstplan-aenderung">Änderungen am Dienstplan melden</Label>
        <Switch id="dienstplan-aenderung" checked={dienstplan} onCheckedChange={setDienstplan} />
      </div>
      <div className="flex items-center justify-between gap-4">
        <Label htmlFor="schalter-gesperrt">Vom Administrator gesperrt</Label>
        <Switch id="schalter-gesperrt" disabled />
      </div>
    </div>
  );
}

Barrierefreiheit

  • Switch rendert über Radix ein Element mit der Rolle switch, aria-checked trägt den Zustand. Das ist im Komponententest abgesichert.
  • Tab fokussiert den Schalter, Leertaste und Enter schalten um; auch ein Klick wechselt den Zustand. Alle drei Wege sind im Komponententest abgesichert.
  • Über Label und id wird der sichtbare Text zum zugänglichen Namen – im Test findet getByRole("switch", { name: … }) den Schalter über seine Beschriftung.
  • Ein gesperrter Schalter nimmt keinen Klick an und ändert seinen Zustand nicht.
  • Der Fokusring ist über focus-visible sichtbar, auch im Dunkelmodus; die Komponente ist in hell und dunkel frei von axe-Verstößen.

Props

Props von Switch
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch