SidebarLayout

TextArea

Mehrzeiliges Texteingabefeld. Unterstützt Label, Placeholder, Floating Label, ReadOnly, Disabled, Zeichenbegrenzung via DataAnnotations, AfterValueChanged, AutoSaveCallback, CustomValidationMethod, ValidateOnInput, Größen und Validierung.

Grundvarianten

Standard, mit Placeholder, ohne Label und mit deaktiviertem Floating Label.

Standard
Zeichen: 0
Mit Placeholder
Ohne Label
Floating Label deaktiviert
rows-Attribut

Zustände

ReadOnly: Wert ist sichtbar und kopierbar, aber nicht editierbar – gestrichelter Rahmen.
Disabled: Feld ist vollständig deaktiviert – ausgegraut, halbtransparent.


ReadOnly
ReadOnly (leer)
Disabled
Disabled (leer)

Size

Alle fünf Größen von Xs bis Xl – alle Felder teilen denselben Bindewert.

Xs
Sm
Md (Standard)
Lg
Xl
Aktueller Wert

AfterValueChanged

AfterValueChanged wird nach jeder Wertänderung ausgelöst (Callback ohne Rückgabewert).

AfterValueChanged
Änderungen: 0×

AutoSaveCallback

AutoSaveCallback wird nach jeder Wertänderung ausgelöst – standardmäßig nur wenn das Feld gültig ist (TriggerAutoSaveCallbackOnlyIfValid).

Nur bei gültigem Wert
Gespeichert: –
Immer speichern
Gespeichert: –

CustomValidationMethod

Eigene Validierungslogik ohne DataAnnotations – direkt als Func<string, bool>.

Mindestlänge 20

ValidateOnInput

ValidateOnInput="true" (Standard): Validierung sofort beim Tippen. false: erst nach Verlassen des Feldes.

ValidateOnInput = true
ValidateOnInput = false

Zeichenbegrenzung via DataAnnotations

[MaxLength] wird automatisch ausgewertet – Eingabe wird auf die angegebene Länge gekürzt.

Zeichen: 0 / 100

AutoGrow & MaxHeight

AutoGrow="true" lässt das Feld mit dem Text wachsen (mit rows="1" einzeilig beginnend), MaxHeight begrenzt es; darüber scrollt es.

AutoGrow, MaxHeight="10rem"

Chat-Eingabe (Borderless, OnEnter, InsertAtCursorAsync)

Borderless für ein Feld in einer eigenen Karte. OnEnter sendet mit Enter ab, Shift+Enter bricht um (mit dem Finger bleibt Enter ein Umbruch). InsertAtCursorAsync fügt an der Cursorstelle ein, FocusAsync setzt den Fokus.

Zuletzt gesendet: –

Validierung mit DataAnnotations

Integration in EditContext via Form-Komponente und DataAnnotationsValidator. ShowValidationTooltip zeigt Fehlermeldungen inline.

class & style

Beliebige HTML-Attribute (class, style, data-*, aria-*) werden an den Input-Wrapper durchgereicht.

class
style
aria-label
data-testid
SKILL.md – Textarea
---
name: TextArea
description: Onesown Blazor Komponente TextArea (Inputs). Verwende diesen Skill wenn du die TextArea-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# TextArea

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `FormControlBase`  

Mehrzeiliges Texteingabefeld mit Floating-Label, DataAnnotations-Validierung und MaxLength-Auswertung. Verhält sich wie TextBox, jedoch als textarea-Element ohne Clear-Button. Optional wächst es mit dem Text, kommt ohne Rahmen aus (etwa als Chat-Eingabe in einer eigenen Karte) und meldet Enter zum Absenden.

**Live-Demo:** https://components.schini.com/demo/textarea  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``ValidateOnInput`` | ``bool`` | ``true`` | Validiert das Feld bei jedem Tastendruck (oninput), nicht erst beim Verlassen des Felds (onchange). Standard: true. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung, Floating-Label-Text und MaxLength-Auswertung. |
| ``ValueChanged`` | ``EventCallback<string>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Wertänderung ausgelöst. |
| ``Value`` | ``string`` |  | Aktuell gebundener Textwert. |
| ``CustomValidationMethod`` | ``Func<string, bool>`` |  | Optionale zusätzliche Validierungsfunktion. Gibt true zurück wenn der Wert gültig ist, false wenn nicht. Ergänzt DataAnnotations-Validierung. |
| ``Readonly`` | ``bool`` |  | Setzt das Feld in den Nur-Lesen-Modus: Eingabe gesperrt, aber nicht ausgegraut. Der Wert bleibt selektierbar und kopierbar. |
| ``AutoGrow`` | ``bool`` |  | Das Feld wächst mit dem Text (CSS field-sizing: content) statt eine feste Zeilenzahl zu haben; mit rows="1" beginnt es einzeilig. Begrenzen über MaxHeight. Browser ohne field-sizing zeigen die feste Höhe aus rows. Standard: false. |
| ``MaxHeight`` | ``string`` |  | Höchsthöhe des Felds als CSS-Wert (z. B. "40vh", "12rem"); darüber scrollt es. Vor allem mit AutoGrow sinnvoll. |
| ``Borderless`` | ``bool`` |  | Ohne Rahmen und Hintergrund, mit knappem Innenabstand und ohne Mindesthöhe der Größe: für ein Feld, das in einer eigenen Karte oder Werkzeugleiste sitzt, etwa die Eingabe eines Chats. Standard: false. |
| ``OnEnter`` | ``EventCallback`` |  | Wird bei Enter ohne Shift ausgelöst; der Zeilenumbruch unterbleibt dann, Shift+Enter bricht weiter um. Erkannt im Browser, daher nur bei Enter ein Roundtrip. Bei Bedienung mit dem Finger (pointer: coarse) bleibt Enter ein Zeilenumbruch, weil die Bildschirmtastatur kein Shift+Enter hat; dort braucht es einen Knopf zum Absenden. Während einer IME-Eingabe zählt Enter nicht. |

## Geerbte Parameter (FormControlBase)

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | ``OoSize.Md`` | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |
| ``Id`` | ``string`` | ``Generator.GenerateRandomHtmlTagID()`` | Eindeutige HTML-ID des Input-Elements. Wird automatisch generiert und kann überschrieben werden (z. B. für Labels mit for-Attribut). |
| ``ShowLabel`` | ``bool`` | ``true`` | Blendet das Label über dem Eingabefeld ein oder aus. Standard: true. |
| ``IsFloatingLabel`` | ``bool`` | ``true`` | Aktiviert das schwebende Label (Floating Label), das beim Fokus oder bei Eingabe nach oben animiert. false = festes Label über dem Feld. Standard: true bzw. OoDefaults.Input.IsFloatingLabel. |
| ``Label`` | ``string`` |  | Beschriftung des Eingabefelds. Wird auch als Accessible-Name für Screenreader verwendet. |
| ``Placeholder`` | ``string`` | ``" "`` | Platzhaltertext im leeren Eingabefeld. Standard: Leerzeichen (verhindert Floating-Label-Sprung in Chrome). |
| ``AutoSaveCallback`` | ``EventCallback`` |  | Wird nach jeder Wertänderung ausgelöst und signalisiert der Seite, dass gespeichert werden soll. Kombinierbar mit TriggerAutoSaveCallbackOnlyIfValid. |
| ``TriggerAutoSaveCallbackOnlyIfValid`` | ``bool`` | ``true`` | Steuert ob AutoSaveCallback nur bei gültigem Wert ausgelöst wird. Standard: true. |
| ``AfterValueChanged`` | ``EventCallback`` |  | Wird nach jeder Wertänderung ausgelöst, unabhängig von der Gültigkeit des Werts. Geeignet für Live-Vorschau oder Seiteneffekte. |
| ``ShowValidationTooltip`` | ``bool`` | ``false`` | Zeigt Validierungsmeldungen als Tooltip neben dem Feld statt als Text darunter. Standard: false. |

## Hinweise

- Immer @bind-Value für Two-Way-Binding verwenden
- Für Formular-Validierung ValueExpression="() => _model.Property" setzen
- Komponente muss innerhalb eines &lt;Form&gt;- oder &lt;EditForm&gt;-Containers liegen, damit der EditContext greift
- AutoSaveCallback wird nach jeder gültigen Änderung ausgelöst, wenn TriggerAutoSaveCallbackOnlyIfValid=true (Standard)
- AfterValueChanged wird nach jeder Änderung ausgelöst, unabhängig von der Gültigkeit
- ShowValidationTooltip=true zeigt Validierungsmeldungen als Tooltip statt unter dem Feld
- Eingabefelder (nicht Button/ToggleButton): Defaults für IsFloatingLabel und Size über DefaultsBereich (Input, ersatzweise Size), appweit im Root-Layout; ein Parameter an der Instanz hat Vorrang
- Ändert sich nur ein Cascading-Wert, werden die direkten Parameter nicht erneut gesetzt: Ein Eingabefeld rendert beim Tippen nie den vorigen Wert; inhaltlich gleiche OoDefaults lösen kein Rendern aus
- Mitwachsen: AutoGrow="true" (CSS field-sizing), mit MaxHeight="40vh" begrenzt; darüber scrollt das Feld
- Ohne Rahmen und Hintergrund: Borderless="true", für ein Feld in einer umgebenden Karte
- Absenden mit Enter: OnEnter; Shift+Enter bricht um. Mit dem Finger bleibt Enter ein Umbruch (keine Shift-Taste auf der Bildschirmtastatur)
- Per Code: FocusAsync() setzt den Fokus, InsertAtCursorAsync(text) fügt an der Cursorstelle ein bzw. ersetzt die Auswahl
- Floating-Label: Label wird automatisch aus [Display]-Annotation gelesen, wenn ValueExpression gesetzt ist
- MaxLength wird automatisch aus [MaxLength]-DataAnnotation gelesen, wenn ValueExpression gesetzt ist
- Echtzeit-Validierung: ValidateOnInput="true" (Standard) validiert bei jedem Tastendruck
- Nur-Lesen-Modus: Readonly="true" sperrt Eingabe, lässt den Text aber selektierbar
- Eigene Validierung: CustomValidationMethod ergänzt DataAnnotations-Validierung mit eigenem Delegate


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.