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:
| Figma | Umsetzung |
|---|---|
| Default / Default Hover | Grundzustand bzw. Mauszeiger über dem Feld |
| Error / Error Hover | error oder ein Validierungsfehler, nachdem das Feld touched ist |
| Disabled | disabled (auch readonly wird so dargestellt) |
| Unfilled | leeres Feld: das Label steht groß im Feld |
| Filled | Feld mit Wert: das Label steht klein über dem Text |
| Focused empty | fokussiertes, leeres Feld ohne placeholder |
| Focused placeholder | fokussiertes, leeres Feld mit placeholder |
Dazu kommen die beiden Properties:
| Figma | Umsetzung |
|---|---|
| Show Character Counter | showCounter – Zeichenzahl oben rechts, mit maxLength als 0/20, sonst nur die Zahl |
| Show Flexible Size | resize="vertical" (Default) – Resize-Handle unten rechts, resize="none" blendet ihn aus |
State
Weitere Properties
Edge Cases
<!-- State: Hover und Focused entstehen erst durch Interaktion -->
<div class="group">
<p>State</p>
<div class="row">
<figure>
<figcaption>Unfilled</figcaption>
<mmm-textarea
label="Ihre Nachricht"
placeholder="Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore."
></mmm-textarea>
</figure>
<figure>
<figcaption>Filled</figcaption>
<mmm-textarea label="Ihre Nachricht" value="Input"></mmm-textarea>
</figure>
<figure>
<figcaption>Error</figcaption>
<mmm-textarea
label="Ihre Nachricht"
[error]="true"
errorMessage="Error"
></mmm-textarea>
</figure>
<figure>
<figcaption>Disabled</figcaption>
<mmm-textarea
label="Ihre Nachricht"
value="Input"
[disabled]="true"
></mmm-textarea>
</figure>
<figure>
<figcaption>Compact</figcaption>
<mmm-textarea
label="Ihre Nachricht"
resize="none"
[compact]="true"
></mmm-textarea>
</figure>
</div>
</div>
<!-- Show Character Counter, Show Flexible Size -->
<div class="group">
<p>Weitere Properties</p>
<div class="row">
<figure>
<figcaption>Show Character Counter → showCounter</figcaption>
<mmm-textarea
label="Ihre Nachricht"
[maxLength]="20"
[showCounter]="true"
></mmm-textarea>
</figure>
<figure>
<figcaption>Show Flexible Size → resize="vertical"</figcaption>
<mmm-textarea label="Ihre Nachricht" resize="vertical"></mmm-textarea>
</figure>
</div>
</div>
<!-- Edge Cases -->
<div class="group">
<p>Edge Cases</p>
<div class="row">
<figure>
<figcaption>Überlänge eines Labels</figcaption>
<mmm-textarea
label="Dies ist ein langes Label, welches so angezeigt wird"
></mmm-textarea>
</figure>
<figure>
<figcaption>Überlänge eines Value Textes</figcaption>
<mmm-textarea
label="Label"
value="Dies ist ein langer Text, der das Verhalten des Values zeigt"
></mmm-textarea>
</figure>
</div>
</div>
Inputs
| Input | Typ | Default | Beschreibung |
|---|---|---|---|
value | string | '' | Wert des Feldes. Unterstützt [(value)] |
label | string | – | Feldlabel |
placeholder | string | – | Platzhalter, nur im fokussierten, leeren Feld sichtbar |
supportingText | string | – | Hilfetext unter dem Feld |
error | boolean | false | Aktiviert den Error-State manuell |
errorMessage | string | – | Fehlermeldung im Error-State |
disabled | boolean | false | Deaktiviert das Feld |
readonly | boolean | false | Verhindert Änderungen, das Feld bleibt fokussierbar |
required | boolean | false | Markiert das Feld als Pflichtfeld (Sternchen am Label) |
hidden | boolean | false | Blendet das Feld aus |
name | string | '' | name der nativen Textarea |
ariaLabel | string | – | Alternativer Screenreader-Text, ersetzt label |
minLength | number | – | Minimale Zeichenzahl (natives minlength) |
maxLength | number | – | Maximale Zeichenzahl (natives maxlength), Grundlage für den Counter |
showCounter | boolean | false | Zeigt den Zeichenzähler oben rechts |
rows | number | 1 | Sichtbare Zeilen, bei autosize die Mindestzahl |
autosize | boolean | false | Das Feld wächst mit dem Inhalt zwischen rows und maxRows |
maxRows | number | – | Obergrenze für autosize, ohne Wert unbegrenzt |
resize | 'none' | 'vertical' | 'horizontal' | 'both' | 'vertical' | Resize-Handle der nativen Textarea, bei autosize immer 'none' |
compact | boolean | false | Kompakter Modus ohne wanderndes Label, das Label dient als Platzhalter |
submitOnModifierEnter | boolean | false | Ctrl/Cmd+Enter schickt das umschließende Formular ab |
selectOnTabFocus | boolean | true | Markiert 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
| Output | Typ | Beschreibung |
|---|---|---|
valueChange | string | Neuer Wert, Gegenstück zu [(value)] |
input | CustomEvent<{ value: string }> | Native-angelehntes Input-Event bei jeder Eingabe |
change | CustomEvent<{ value: string }> | Native-angelehntes Change-Event, u. a. beim Verlassen |
touch | void | Das 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-bggelegt, 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-inputin 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
Taberreicht, bekommt den gesamten Text markiert (selectOnTabFocus). - Höhe: Standardmäßig zeigt das Feld eine Zeile und ist wie
mmm-input64px hoch, mitcompact40px. Mehr Zeilen gibtrows, größer ziehen lässt es sich am Resize-Handle. - Lange Texte brechen um. Passen sie nicht mehr in
rowsZeilen, scrollt das Feld, oder es wächst mitautosizemit. - Breite: Standardmäßig ist das Feld 320px breit. Die Klassen
mmm-textarea--narrow(12rem) undmmm-textarea--wide(36rem) ändern das,mmm-textarea--blockfüllt den Container. Im Grid gehört diegrid__cell--*-Klasse direkt aufmmm-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: zuersterrorMessage, dann die Fehlermeldungen aus dem Schema, bei deaktiviertem Feld diedisabledReasons, sonstsupportingText.
Beispiel
<!-- Field-Group: 16px Abstand, beide Felder so breit wie ihre Spalte -->
<div class="field-group">
<mmm-input label="Straße, Haus-Nr." value="Musterstraße 1"></mmm-input>
<mmm-textarea
class="mmm-textarea--block"
label="Anmerkung"
placeholder="Bitte teilen Sie uns Ihre Anmerkungen mit"
supportingText="Eine möglichst detaillierte Beschreibung"
[maxLength]="200"
[showCounter]="true"
resize="vertical"
></mmm-textarea>
</div>