Zum Inhalt springen
Dokumentation

Komponenten

Schlagwörter (TagInput)

Stabil

Mehrere kurze Begriffe als Etiketten erfassen – mit Tastatur und Entfernen-Knopf.

Schlagwörter ordnen Inhalte ohne feste Liste: „Nachtdienst“, „Übergabe“, „Isolation“. Jedes Wort steht als eigenes Etikett im Feld und lässt sich einzeln entfernen.

Wann verwenden

  • Für freie Begriffe, die sich nicht sinnvoll in eine feste Auswahl pressen lassen, etwa Aushänge oder Wissensnotizen.
  • Wenn mehrere Werte gleichzeitig gelten und die Liste kurz bleibt.
  • Wenn Nutzer Begriffe schnell tippen und mit Enter bestätigen sollen.

Wann nicht

  • Für eine feste Liste mit bekannter Bedeutung nimm Select oder Combobox; dort gibt es keine Tippfehler und keine Dubletten.
  • Für einen einzelnen Wert ist ein Eingabefeld einfacher.
  • Für sehr viele Einträge, die durchsucht werden müssen, ist eine Tabelle mit Filter besser.

Etiketten erfassen

value und onValueChange tragen die Liste. Enter oder ein Komma fügt den getippten Begriff hinzu, im leeren Feld entfernt Backspace das letzte Etikett. Jedes Etikett hat einen eigenen Entfernen-Knopf.

NachtdienstÜbergabe

2 Schlagwörter – Enter oder Komma fügt eines hinzu.

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

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

function Etiketten() {
  const [tags, setTags] = React.useState(["Nachtdienst", "Übergabe"]);

  return (
    <div className="flex w-full max-w-md flex-col gap-2">
      <Label htmlFor="aushang-tags">Schlagwörter für den Aushang</Label>
      <TagInput
        id="aushang-tags"
        value={tags}
        onValueChange={setTags}
        placeholder="Schlagwort eingeben"
      />
      <p className="text-xs text-muted-foreground">
        {tags.length} Schlagwörter – Enter oder Komma fügt eines hinzu.
      </p>
    </div>
  );
}

Leeres Feld

Ohne Vorgabe startet die Liste leer; der Platzhalter nennt ein Beispiel aus dem Alltag. Jeder bestätigte Begriff erscheint sofort als Etikett.

Noch keine Schlagwörter erfasst.

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

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

function Neu() {
  const [tags, setTags] = React.useState<string[]>([]);

  return (
    <div className="flex w-full max-w-md flex-col gap-2">
      <Label htmlFor="neue-tags">Schlagwörter für die Übergabe</Label>
      <TagInput
        id="neue-tags"
        value={tags}
        onValueChange={setTags}
        placeholder="Zum Beispiel „Isolation“"
      />
      <p className="text-xs text-muted-foreground">
        {tags.length === 0
          ? "Noch keine Schlagwörter erfasst."
          : `${tags.length} Schlagwörter erfasst.`}
      </p>
    </div>
  );
}

Barrierefreiheit

  • Das Eingabefeld ist ein natives input; der zugängliche Name kommt aus der verbundenen Beschriftung.
  • Enter oder ein Komma fügt einen Begriff hinzu und leert das Feld. Das ist im Komponententest abgesichert.
  • Backspace im leeren Feld entfernt das letzte Etikett; Dubletten werden ignoriert. Beides prüft der Komponententest.
  • Der Entfernen-Knopf jedes Etiketts ist ein button mit einem Namen aus dem Nachrichtenkatalog, zum Beispiel „React entfernen“. Der Test findet ihn über diesen Namen.
  • Mit disabled bleiben die Etiketten sichtbar; Feld und Entfernen-Knöpfe sind dann nicht bedienbar.
  • Das Feld ist in hell und dunkel frei von axe-Verstößen.

Props

Props von TagInput
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
containerClassNamestring–NeinAdditional classes for the wrapper container.
disabledboolean–Nein–
inputClassNamestring–NeinAdditional classes for the inner text input.
onValueChange(value: string[]) => void–JaCalled with the next tag array when a tag is added or removed.
valuestring[]–JaCurrent tags in display order.

Siehe auch