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

true

Das Textfeld akzeptiert mehrere Zeilen Eingaben.

false

Das Textfeld akzeptiert nur eine einzelne Zeile Eingaben.

Zugehörige Schnittstellen

Element.ariaMultiLine

Die ariaMultiLine-Eigenschaft, Teil der Element-Schnittstelle, spiegelt den Wert des aria-multiline-Attributs wider.

ElementInternals.ariaMultiLine

Die ariaMultiLine-Eigenschaft, Teil der ElementInternals-Schnittstelle, spiegelt den Wert des aria-multiline-Attributs wider.

Zugehörige Rollen

Genutzt in Rollen:

Erbt in Rollen:

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-multiline

Siehe auch