Zum Inhalt springen
Dokumentation

Komponenten

Beschriftung (Label)

Stabil

Formularfelder eindeutig benennen – verbunden über htmlFor und id.

Eine Beschriftung benennt ein Formularfeld. Sie bleibt sichtbar, wenn der Platzhalter beim Tippen verschwindet, und sie ist der zugängliche Name, den ein Screenreader vorliest.

Wann verwenden

  • Für jedes Eingabefeld, jeden Textbereich und jede Auswahl im Formular.
  • Für Umschaltungen wie Checkbox, Switch und RadioGroup, deren sichtbarer Text sonst fehlt.
  • Wenn ein Feld einen kurzen Hinweis braucht: Die Beschriftung nennt den Begriff, der Hinweis darunter erklärt ihn.

Wann nicht

  • Als Ersatz für den Platzhalter: Ein Platzhalter ist kein Feldname.
  • Für Überschriften oder Fließtext – dafür gibt es Überschriften-Elemente.
  • Für Schaltflächen: Deren Text ist bereits ihr zugänglicher Name.

Felder verbinden

htmlFor zeigt auf die id des Feldes. Nur so springt ein Klick auf die Beschriftung in das Feld, und nur so liest der Screenreader beides zusammen vor.

Beispiel und Quelltext
formularfeld.tsx
import { Input, Label } from "@neodin-eu/ui";

function Formularfeld() {
  return (
    <div className="flex w-full max-w-sm flex-col gap-2">
      <Label htmlFor="ticket">Ticket</Label>
      <Input id="ticket" placeholder="T-1042" />
    </div>
  );
}

Umschaltungen

Auch Kontrollkästchen und Schalter bekommen eine eigene Beschriftung. Sie stehen in der Regel rechts vom Bedienelement.

Beispiel und Quelltext
umschaltung.tsx
import { Checkbox, Label, Switch } from "@neodin-eu/ui";

function Umschaltung() {
  return (
    <div className="flex flex-col gap-4">
      <div className="flex items-center gap-2">
        <Checkbox id="rueckfrage" />
        <Label htmlFor="rueckfrage">Rückfrage an die Station</Label>
      </div>
      <div className="flex items-center gap-2">
        <Switch id="benachrichtigung" />
        <Label htmlFor="benachrichtigung">Bei neuen Tickets benachrichtigen</Label>
      </div>
    </div>
  );
}

Barrierefreiheit

  • Label rendert über Radix ein natives label-Element. Ein Klick auf den Text setzt den Fokus ins verbundene Feld – das ist das Verhalten des nativen Elements.
  • Die Zuordnung zum Feld ist im Komponententest abgesichert: getByLabelText("Name") findet dort genau das verbundene Textfeld.
  • Die Verbindung entsteht über htmlFor und id. Ohne sie bleibt der zugängliche Name des Feldes leer.
  • Für gesperrte Felder bringt die Komponente Styles mit, die die Beschriftung ausgrauen; sie greifen über peer-disabled oder group-data-[disabled=true].
  • Die Komponente ist im Test in hell und dunkel frei von axe-Verstößen.

Props

Props von Label
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–

Siehe auch