Komponenten
Schlagwörter (TagInput)
StabilMehrere 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
Enterbestätigen sollen.
Wann nicht
- Für eine feste Liste mit bekannter Bedeutung nimm
SelectoderCombobox; 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.
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.
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. Enteroder ein Komma fügt einen Begriff hinzu und leert das Feld. Das ist im Komponententest abgesichert.Backspaceim leeren Feld entfernt das letzte Etikett; Dubletten werden ignoriert. Beides prüft der Komponententest.- Der Entfernen-Knopf jedes Etiketts ist ein
buttonmit einem Namen aus dem Nachrichtenkatalog, zum Beispiel „React entfernen“. Der Test findet ihn über diesen Namen. - Mit
disabledbleiben 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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| containerClassName | string | – | Nein | Additional classes for the wrapper container. |
| disabled | boolean | – | Nein | – |
| inputClassName | string | – | Nein | Additional classes for the inner text input. |
| onValueChange | (value: string[]) => void | – | Ja | Called with the next tag array when a tag is added or removed. |
| value | string[] | – | Ja | Current tags in display order. |