ARIA: aria-multiline Attribut
Das aria-multiline Attribut gibt an, ob ein textbox mehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile.
Beschreibung
Das Standardverhalten der Eingabe- oder Return-Taste unterscheidet sich zwischen einzeiligen und mehrzeiligen Textfeldern. Wenn der Benutzerfokus in einem einzeiligen <input type="text"> liegt, wird ein Eingabe- oder Return-Tastendruck üblicherweise das Formular abschicken.
Wenn der Benutzerfokus in einem mehrzeiligen <textarea> liegt, fügt der Tastendruck einen Zeilenumbruch ein. Nur relevant für Elemente mit der Rolle textbox, zeigt das aria-multiline Attribut unterstützenden Technologien an, ob das Textfeld mehrere Zeilen Eingabe oder nur eine einzelne Zeile akzeptiert. Es setzt Erwartungen, welche Art von Daten eingegeben werden sollen und was diese Tastendrucke bewirken.
Hinweis:
Wenn möglich, verwenden Sie das HTML <input> oder das <textarea>, da diese eingebaute Semantik und Verhaltensweisen haben, keine ARIA-Attribute oder Skripte benötigen und integrierte Tastaturunterstützung bieten.
Wenn aria-multiline="true" gesetzt ist, bedeutet dies, dass das Textbox-Widget Zeilenumbrüche innerhalb der Eingabe akzeptiert, ähnlich dem HTML <textarea>. Elemente mit der Rolle textbox, die das Attribut nicht haben oder bei denen der Wert auf false gesetzt ist, sind einfache Textboxen.
Achten Sie bei der Gestaltung von Textfeldern auf Fokus und Tastendrucke. ARIA ändert nur den Barrierefreiheitsbaum und somit, wie unterstützende Technologien die Textbox Ihren Benutzern präsentieren. ARIA ändert nichts an der Standardfunktion oder dem Verhalten eines Elements. Wenn semantische HTML-Elemente nicht für ihren vorgesehenen Zweck und ihre Standardeigenschaften verwendet werden, müssen Sie JavaScript verwenden, um Verhalten und Funktionalität, einschließlich der Reaktion auf Tastendruckereignisse, zu verwalten.
Werte
Zugehörige Schnittstellen
Element.ariaMultiLine-
Die
ariaMultiLineEigenschaft, Teil derElementSchnittstelle, spiegelt den Wert desaria-multilineAttributs wider. ElementInternals.ariaMultiLine-
Die
ariaMultiLineEigenschaft, Teil derElementInternalsSchnittstelle, spiegelt den Wert desaria-multilineAttributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Wird vererbt in Rollen:
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-multiline |