Zum Inhalt springen

Dokumentation

Komponenten

Textareas

Mehrzeilige Eingabefelder für längere Texte und Sammlungen von Tags.

Verwendung

Eine Textarea erfasst längere Texte wie Beschreibungen oder Notizen. Beschrifte das Feld mit einem label.

Standard-Textarea
blade
<gedisa:textarea label="Beschreibung" placeholder="Beschreibung eingeben …" />

Label, Hinweis und Tooltip

required ergänzt den Pflichtstern, description zeigt einen Hinweis unter dem Feld. Der tooltip steht bei Textareas neben dem Label.

Vollständiges Feld
Kurzer Text über das Team.

Das ist ein Hinweistext.

blade
<gedisa:textarea label="Beschreibung" required tooltip="Kurzer Text über das Team." description="Das ist ein Hinweistext." placeholder="Beschreibung eingeben …" />

Zeilen und Größenänderung

rows legt die Starthöhe fest. Mit resize="none" lässt sich die Höhe nicht mehr ziehen.

Zwei Zeilen ohne Größenänderung
blade
<gedisa:textarea label="Notiz" rows="2" resize="none" placeholder="Notiz eingeben …" />

Validierung

Mit wire:model zeigt die Textarea Fehler aus der Livewire-Validierung automatisch an. Das Beispiel prüft live und zählt die Zeichen.

Live-Validierung mit Zeichenzähler

0 / 280 Zeichen

blade
<gedisa:textarea wire:model.live.debounce.300ms="description" label="Beschreibung" required placeholder="Beschreibung eingeben …" :description="mb_strlen($description) . ' / 280 Zeichen'" />

Tags

gedisa:textarea.tags sammelt mehrere Werte als Tags in einem mehrzeiligen Feld. Enter oder Komma fügt hinzu, Backspace oder × entfernt. Das Beispiel erlaubt maximal fünf Tags.

Tags mit Livewire
Enter oder Komma fügt hinzu.

2 / 5 Tags

blade
<gedisa:textarea.tags wire:model.live="tags" label="Tags" required tooltip="Enter oder Komma fügt hinzu." placeholder="Tags hinzufügen …" :description="count($tags) . ' / 5 Tags'" />

Zustände

disabled sperrt das Feld, error setzt eine Fehlermeldung manuell.

Deaktiviert und Fehler

Das Feld ist gesperrt.

blade
<gedisa:textarea label="Beschreibung" disabled description="Das Feld ist gesperrt.">Ein wenig über das Unternehmen und das Team.</gedisa:textarea>
<gedisa:textarea.tags label="Tags" :value="['Design', 'Software']" error="Maximal 5 Tags erlaubt." />

Referenz

Diese Übersicht umfasst die gezeigten Attribute. Weitere Attribute werden an die native Textarea weitergereicht.

gedisa:textarea

Eigenschaft
Werte
Default
label Beschriftung des Feldes
required Attribut für Pflichtfelder mit Stern
description Hinweistext unter dem Feld
tooltip Hilfetext hinter einem Icon neben dem Label
error Fehlermeldung, ersetzt den Hinweistext
invalid Markiert das Feld als fehlerhaft
rows Anzahl sichtbarer Zeilen 4
resize vertical, none vertical

gedisa:textarea.tags

Eigenschaft
Werte
Default
value Startwerte ohne Livewire []
wire:model Bindung eines Arrays
name Sendet die Werte als name[] ohne Livewire
placeholder Placeholder des Eingabefeldes
remove-label Zugänglicher Name der Entfernen-Buttons Entfernen