Zum Inhalt springen
Dokumentation

Komponenten

Textbereich (Textarea)

Stabil

Mehrzeiligen Text erfassen – Notizen, Begründungen und Übergaben.

Ein Textbereich erfasst mehrere Zeilen freien Text. Er wächst mit dem Inhalt und ist die richtige Stelle für alles, was länger als eine Zeile wird.

Wann verwenden

  • Für Notizen zur Übergabe, Begründungen und Kommentare am Ticket.
  • Für Freitext, der Absätze oder Zeilenumbrüche braucht.
  • Wenn absehbar ist, dass eine Antwort mehr als einen Satz umfasst.

Wann nicht

  • Für einen einzelnen Wert wie einen Namen oder eine Nummer reicht ein Eingabefeld.
  • Für eine Auswahl aus festen Werten ist ein Select passender.
  • Für formatierte Inhalte mit Überschriften und Listen ist ein reines Textfeld zu wenig – dafür braucht es einen eigenen Editor.

Erfassung

rows gibt die sichtbare Höhe vor. Der Platzhalter deutet an, was hineingehört; die eigentliche Anweisung steht in der Beschriftung und im Hinweistext darunter.

Kurz und sachlich, ohne Namen von Patientinnen und Patienten.

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

function Notiz() {
  return (
    <div className="flex w-full max-w-md flex-col gap-2">
      <Label htmlFor="uebergabe">Notiz zur Übergabe</Label>
      <Textarea
        id="uebergabe"
        name="uebergabe"
        rows={4}
        placeholder="Was soll das nächste Team wissen?"
      />
      <p className="text-xs text-muted-foreground">
        Kurz und sachlich, ohne Namen von Patientinnen und Patienten.
      </p>
    </div>
  );
}

Zustände

Fehler und Sperren funktionieren wie beim Eingabefeld: aria-invalid für den Fehlerzustand und disabled für ein Feld, das nicht bearbeitet werden darf.

Bitte eine Begründung eintragen.

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

function Zustaende() {
  return (
    <div className="flex w-full max-w-md flex-col gap-4">
      <div className="flex flex-col gap-2">
        <Label htmlFor="begruendung">Begründung</Label>
        <Textarea id="begruendung" aria-invalid />
        <p className="text-xs text-destructive">Bitte eine Begründung eintragen.</p>
      </div>
      <div className="flex flex-col gap-2">
        <Label htmlFor="archiv">Archivnotiz</Label>
        <Textarea id="archiv" disabled defaultValue="Abgeschlossen am 12.11." />
      </div>
    </div>
  );
}

Barrierefreiheit

  • Textarea rendert ein natives textarea-Element. Enter erzeugt einen Zeilenumbruch, Tab verlässt das Feld – das Formular wird nicht über die Eingabetaste abgeschickt.
  • Der zugängliche Name kommt aus dem verbundenen Label, nicht aus dem Platzhalter.
  • aria-invalid wird unverändert weitergegeben und ist im Komponententest abgesichert; die Komponente ist dort in hell und dunkel frei von axe-Verstößen.
  • Ein Feld mit disabled ist nicht fokussierbar und wird nicht abgeschickt.

Props

Props von Textarea
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch