aria-multiline

Das aria-multiline Attribut gibt an, ob ein textbox mehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile.

Beschreibung

Das Standardverhalten der Tasten Enter oder Return unterscheidet sich zwischen einzeiligen und mehrzeiligen Textfeldern. Wenn der Benutzerfokus in einem einzeiligen <input type="text"> liegt, führt ein Tastendruck auf Enter oder Return normalerweise dazu, dass das Formular gesendet wird.

Wenn der Benutzerfokus in einem mehrzeiligen <textarea> liegt, fügt der Tastendruck einen Zeilenumbruch ein. Nur relevant für Elemente mit der gesetzten Rolle textbox, zeigt das aria-multiline Attribut unterstützenden Technologien an, ob dieses Textfeld mehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile. Dies setzt Erwartungen in Bezug auf die Art der einzugebenden Daten und das Verhalten bei Tastendrücken.

Hinweis: Wenn möglich, verwenden Sie das HTML <input> oder das <textarea>, da diese integrierte Semantik und Verhaltensweisen haben, keine ARIA-Attribute oder Skripte erfordern und die Tastaturunterstützung eingebaut ist.

Wenn aria-multiline="true" gesetzt ist, bedeutet dies, dass das Textfeld-Widget Zeilenumbrüche innerhalb der Eingabe akzeptiert, ähnlich dem HTML <textarea>. Elemente mit der Rolle textbox, die das Attribut nicht haben oder deren Wert auf false gesetzt ist, sind einfache Textfelder.

Beachten Sie den Fokus und die Tastenanschläge beim Entwerfen von Textfeldern. ARIA ändert nur den Barrierefreiheitsbaum und damit, wie unterstützende Technologie das Textfeld Ihren Benutzern präsentiert. ARIA ändert nichts an der Standardfunktion oder dem Standardverhalten eines Elements. Wenn Sie keine semantischen HTML-Elemente für ihren vorgesehenen Zweck und die Standardfunktionen verwenden, müssen Sie JavaScript verwenden, um Verhalten und Funktionalität zu steuern, einschließlich der Reaktion auf Tastendruck-Ereignisse.

Werte

true

Das Textfeld akzeptiert mehrere Zeilen Eingabe.

false

Das Textfeld akzeptiert nur eine einzelne Zeile Eingabe.

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

Verwendet in Rollen:

Vererbt in Rollen:

Spezifikationen

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

Siehe auch