ARIA: aria-multiline Attribut

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

Beschreibung

Das Standardverhalten der Enter- oder Return-Taste unterscheidet sich zwischen einzeiligen und mehrzeiligen Textfeldern. Wenn der Benutzerfokus in einem einzeiligen <input type="text"> ist, sendet ein Enter- oder Return-Tastendruck normalerweise das Formular ab.

Wenn der Benutzerfokus in einem mehrzeiligen <textarea> ist, fügt der Tastendruck einen Zeilenumbruch ein. Nur relevant für Elemente mit der textbox Rollenfestlegung zeigt das aria-multiline Attribut unterstützenden Technologien an, ob dieses Textfeld mehrere Zeilen Eingabe oder nur eine einzelne Zeile akzeptiert, und setzt Erwartungen darüber, welche Art von Daten eingegeben werden sollen und was diese Tastendrücke bewirken.

Hinweis: Wenn möglich, nutzen Sie das HTML <input> oder das <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 Textbox-Widget Zeilenumbrüche innerhalb der Eingabe akzeptiert, ähnlich dem HTML <textarea>. Elemente mit einer Rolle von textbox, die das Attribut nicht haben oder deren Wert auf false gesetzt ist, sind einfache Textboxen.

Achten Sie auf den Fokus und die Tastendrücke beim Entwerfen von Textboxen. ARIA modifiziert nur den Zugänglichkeitsbaum und damit, wie unterstützende Technologien die Textbox Ihren Benutzern präsentieren. ARIA ändert nichts an der Standardfunktion oder dem Verhalten eines Elements. Wenn Sie semantische HTML-Elemente nicht für ihren vorgesehenen Zweck und ihre Standardfunktionalität verwenden, müssen Sie JavaScript einsetzen, um das Verhalten und die Funktionalität zu verwalten, einschließlich der Reaktion auf Tastendruckereignisse.

Werte

true: Die Textbox akzeptiert mehrere Zeilen Eingabe.
false: Die Textbox 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:

textbox

Vererbt in Rollen:

searchbox

Spezifikationen

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

Siehe auch

ARIA textbox Rolle
ARIA searchbox Rolle