aria-multiline
Das Attribut aria-multiline gibt an, ob ein textbox mehrere Zeilen Eingaben akzeptiert oder nur eine einzelne Zeile.
Beschreibung
Das Standardverhalten der Enter- oder Return-Taste unterscheidet sich zwischen einzeiligen und mehrzeiligen Textfeldern. Wenn der Benutzerfokus auf einem einzeiligen <input type="text"> liegt, führt ein Enter- oder Return-Tastendruck normalerweise dazu, dass das Formular gesendet wird.
Wenn der Benutzerfokus auf einem mehrzeiligen <textarea> liegt, fügt der Tastendruck einen Zeilenumbruch ein. Nur relevant für Elemente mit der Rolle textbox, zeigt das Attribut aria-multiline unterstützenden Technologien an, ob dieses Textfeld mehrere Zeilen Eingaben akzeptiert oder nur eine einzelne Zeile und legt damit Erwartungen fest, welche Art von Daten eingegeben werden sollten und was diese Tastendrücke bewirken.
Hinweis: Verwenden Sie, wo immer möglich, das HTML-Element <input> oder <textarea>, da diese eingebaute Semantik und Verhaltensweisen haben, keine ARIA-Attribute oder Skripte erfordern und über integrierte Tastaturunterstützung verfügen.
Wenn aria-multiline="true" gesetzt ist, bedeutet dies, dass das Textfeld-Widget Zeilenumbrüche innerhalb der Eingabe akzeptiert, ähnlich wie das HTML-Element <textarea>. Elemente mit der Rolle textbox, die das Attribut nicht haben oder auf false gesetzt sind, sind einfache Textfelder.
Achten Sie auf Fokus und Tastendrücke, wenn Sie Textfelder gestalten. ARIA ändert nur den Accessibility-Tree und somit, wie unterstützende Technologien das Textfeld Ihren Benutzern präsentieren. ARIA ändert nichts an der Standardfunktion oder dem Standardverhalten eines Elements. Wenn Sie keine semantischen HTML-Elemente für ihren beabsichtigten Zweck und ihre Standardfunktionalität verwenden, müssen Sie JavaScript verwenden, um Verhalten und Funktionalität, einschließlich der Beantwortung von Tastendruckereignissen, zu verwalten.
Werte
Zugehörige Schnittstellen
Element.ariaMultiLine-
Die
ariaMultiLine-Eigenschaft, Teil derElement-Schnittstelle, spiegelt den Wert desaria-multiline-Attributs wider. ElementInternals.ariaMultiLine-
Die
ariaMultiLine-Eigenschaft, Teil derElementInternals-Schnittstelle, spiegelt den Wert desaria-multiline-Attributs wider.
Zugehörige Rollen
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-multiline |