Komponenten
Schalter (Switch)
StabilEine 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.
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
Switchrendert über Radix ein Element mit der Rolleswitch,aria-checkedträgt den Zustand. Das ist im Komponententest abgesichert.Tabfokussiert den Schalter,LeertasteundEnterschalten um; auch ein Klick wechselt den Zustand. Alle drei Wege sind im Komponententest abgesichert.- Über
Labelundidwird der sichtbare Text zum zugänglichen Namen – im Test findetgetByRole("switch", { name: … })den Schalter über seine Beschriftung. - Ein gesperrter Schalter nimmt keinen Klick an und ändert seinen Zustand nicht.
- Der Fokusring ist über
focus-visiblesichtbar, auch im Dunkelmodus; die Komponente ist in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |