Skip to content

Textarea

Überblick

mmm-textarea ist das mehrzeilige Eingabefeld des Designsystems. Im leeren Feld steht das Label groß an der Stelle eines Platzhalters. Sobald das Feld fokussiert ist oder einen Wert hat, wandert es klein an den oberen Rand und macht Platz für den Text. Die Komponente funktioniert mit Signal Forms ([formField]) ebenso wie mit Reactive und Template-driven Forms (ControlValueAccessor).

<mmm-textarea
label="Ihre Nachricht"
placeholder="Bitte teilen Sie uns Ihre Anmerkungen mit"
[maxLength]="500"
[showCounter]="true"
></mmm-textarea>

Varianten

Die Figma-States ergeben sich aus der Interaktion und den Inputs:

FigmaUmsetzung
Default / Default HoverGrundzustand bzw. Mauszeiger über dem Feld
Error / Error Hovererror oder ein Validierungsfehler, nachdem das Feld touched ist
Disableddisabled (auch readonly wird so dargestellt)
Unfilledleeres Feld: das Label steht groß im Feld
FilledFeld mit Wert: das Label steht klein über dem Text
Focused emptyfokussiertes, leeres Feld ohne placeholder
Focused placeholderfokussiertes, leeres Feld mit placeholder

Dazu kommen die beiden Properties:

FigmaUmsetzung
Show Character CountershowCounter – Zeichenzahl oben rechts, mit maxLength als 0/20, sonst nur die Zahl
Show Flexible Sizeresize="vertical" (Default) – Resize-Handle unten rechts, resize="none" blendet ihn aus

State

Unfilled
Filled
Error
Disabled
Compact

Weitere Properties

Show Character Counter → showCounter
Show Flexible Size → resize="vertical"

Edge Cases

Überlänge eines Labels
Überlänge eines Value Textes

Inputs

InputTypDefaultBeschreibung
valuestring''Wert des Feldes. Unterstützt [(value)]
labelstring–Feldlabel
placeholderstring–Platzhalter, nur im fokussierten, leeren Feld sichtbar
supportingTextstring–Hilfetext unter dem Feld
errorbooleanfalseAktiviert den Error-State manuell
errorMessagestring–Fehlermeldung im Error-State
disabledbooleanfalseDeaktiviert das Feld
readonlybooleanfalseVerhindert Änderungen, das Feld bleibt fokussierbar
requiredbooleanfalseMarkiert das Feld als Pflichtfeld (Sternchen am Label)
hiddenbooleanfalseBlendet das Feld aus
namestring''name der nativen Textarea
ariaLabelstring–Alternativer Screenreader-Text, ersetzt label
minLengthnumber–Minimale Zeichenzahl (natives minlength)
maxLengthnumber–Maximale Zeichenzahl (natives maxlength), Grundlage für den Counter
showCounterbooleanfalseZeigt den Zeichenzähler oben rechts
rowsnumber1Sichtbare Zeilen, bei autosize die Mindestzahl
autosizebooleanfalseDas Feld wächst mit dem Inhalt zwischen rows und maxRows
maxRowsnumber–Obergrenze für autosize, ohne Wert unbegrenzt
resize'none' | 'vertical' | 'horizontal' | 'both''vertical'Resize-Handle der nativen Textarea, bei autosize immer 'none'
compactbooleanfalseKompakter Modus ohne wanderndes Label, das Label dient als Platzhalter
submitOnModifierEnterbooleanfalseCtrl/Cmd+Enter schickt das umschließende Formular ab
selectOnTabFocusbooleantrueMarkiert beim Fokus per Tab den gesamten Text

Mit [formField] setzt Signal Forms außerdem touched, invalid, errors und disabledReasons, aus den Schema-Regeln minLength()/maxLength() auch minLength und maxLength.

Outputs

OutputTypBeschreibung
valueChangestringNeuer Wert, Gegenstück zu [(value)]
inputCustomEvent<{ value: string }>Native-angelehntes Input-Event bei jeder Eingabe
changeCustomEvent<{ value: string }>Native-angelehntes Change-Event, u. a. beim Verlassen
touchvoidDas Feld wurde verlassen

SCSS-Variablen

Alle Variablen werden auf mmm-textarea deklariert und lassen sich dort überschreiben.

Farben:

  • --mmm-textarea-bg
  • --mmm-textarea-hover-bg (wird beim Hover über --mmm-textarea-bg gelegt, daher halbtransparent)
  • --mmm-textarea-fg
  • --mmm-textarea-fg-disabled
  • --mmm-textarea-border
  • --mmm-textarea-border-disabled
  • --mmm-textarea-focus (Fokusrahmen und Cursor)
  • --mmm-textarea-error
  • --mmm-textarea-error-bg
  • --mmm-textarea-muted (Label und Counter)
  • --mmm-textarea-placeholder

Rahmen und Maße:

  • --mmm-textarea-border-width
  • --mmm-textarea-border-width-focus
  • --mmm-textarea-border-radius
  • --mmm-textarea-min-height
  • --mmm-textarea-min-height-compact
  • --mmm-textarea-font-size
  • --mmm-textarea-line-height

Abstände, jeweils vom äußeren Rand des Feldes gemessen:

  • --mmm-textarea-padding-inline (Label, Text und Counter)
  • --mmm-textarea-padding-top (Beginn des Textes unter der Label-Zeile)
  • --mmm-textarea-padding-bottom
  • --mmm-textarea-padding-block-compact

Label und Counter:

  • --mmm-textarea-label-offset-block (Label im leeren Feld)
  • --mmm-textarea-label-offset-block-floating (Label oben, Counter)
  • --mmm-textarea-label-font-size (Label oben, Counter)
  • --mmm-textarea-header-gap (Mindestabstand zwischen Label und Counter)

Breite:

  • --mmm-textarea-width
  • --mmm-textarea-native-width
  • --mmm-textarea-native-min-width

Meldungen unter dem Feld:

  • --mmm-textarea-footer-gap
  • --mmm-textarea-footer-padding
  • --mmm-textarea-footer-min-height

Hinweise

  • Label: Im leeren Feld ist das Label wie bei mmm-input in den oberen 64px zentriert. Es ist einzeilig, zu lange Labels werden mit „…“ gekürzt, mit Counter schon vor dem Counter. Das Label bleibt in jedem Zustand grau, auch bei Fokus und Fehler.
  • Fokus: Ein Klick setzt den Cursor an die geklickte Stelle des Textes. Wer das Feld per Tab erreicht, bekommt den gesamten Text markiert (selectOnTabFocus).
  • Höhe: Standardmäßig zeigt das Feld eine Zeile und ist wie mmm-input 64px hoch, mit compact 40px. Mehr Zeilen gibt rows, größer ziehen lässt es sich am Resize-Handle.
  • Lange Texte brechen um. Passen sie nicht mehr in rows Zeilen, scrollt das Feld, oder es wächst mit autosize mit.
  • Breite: Standardmäßig ist das Feld 320px breit. Die Klassen mmm-textarea--narrow (12rem) und mmm-textarea--wide (36rem) ändern das, mmm-textarea--block füllt den Container. Im Grid gehört die grid__cell--*-Klasse direkt auf mmm-textarea, dann füllt das Feld seine Spalte. Füllt es den Container, verändert der Resize-Handle nur die Höhe.
  • Field-Group: Zwischen Feldern einer Gruppe liegen 16px. Die Komponente hat selbst keinen Außenabstand, den Abstand setzt der umgebende Container (z. B. gap: 1rem).
  • Meldungen unter dem Feld rendert mmm-field-message. Fehlertexte haben Vorrang: zuerst errorMessage, dann die Fehlermeldungen aus dem Schema, bei deaktiviertem Feld die disabledReasons, sonst supportingText.

Beispiel