ARIA: form-Rolle
Die Rolle form kann verwendet werden, um eine Gruppe von Elementen auf einer Seite zu kennzeichnen, die dieselbe Funktionalität wie ein HTML-Formular bietet. Das Formular wird nur dann als Landmark-Region bereitgestellt, wenn es einen zugänglichen Namen hat.
<div role="form" id="contact-info" aria-label="Contact information">
<!-- form content -->
</div>
Dieses Formular erfasst und speichert die Kontaktdaten eines Benutzers.
Warnung:
Verwenden Sie ein HTML-Element <form> für Ihre Formularsteuerelemente statt der ARIA-Rolle form, sofern Sie keinen sehr guten Grund haben, davon abzuweichen.
Das HTML-Element <form> reicht aus, um assistierenden Technologien mitzuteilen, dass es sich um ein Formular handelt.
Beschreibung
Eine form-Landmark kennzeichnet einen Inhaltsbereich mit einer Sammlung von Elementen und Objekten, die zusammen ein Formular bilden, wenn keine andere benannte Landmark geeignet ist (z. B. main oder search).
Hinweis:
Das Element <form> kennzeichnet einen Inhaltsbereich automatisch als form-Landmark, wenn es einen zugänglichen Namen hat. Entwickler sollten stets das passende semantische HTML-Element der Verwendung von ARIA vorziehen.
Verwenden Sie nach Möglichkeit das HTML-Element <form>. Das Element <form> definiert eine form-Landmark, wenn es einen zugänglichen Namen hat (z. B. über aria-labelledby, aria-label oder title). Geben Sie jedem Formular in einem Dokument eine eindeutige Beschriftung, damit Benutzer den Zweck des Formulars verstehen können. Diese Beschriftung sollte für alle Benutzer sichtbar sein, nicht nur für Benutzer assistierender Technologien. Verwenden Sie die Landmark search statt der Landmark form, wenn das Formular für eine Suchfunktion verwendet wird.
Verwenden Sie role="form", um einen Bereich der Seite zu kennzeichnen, nicht jedes einzelne Formularfeld. Auch wenn Sie die Formular-Landmark statt <form> verwenden, sollten Sie native HTML-Formularsteuerelemente wie <button>, <input>, <select> und <textarea> verwenden.
Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften
Keine rollenspezifischen Zustände oder Eigenschaften.
Tastaturinteraktionen
Keine rollenspezifischen Tastaturinteraktionen.
Erforderliche JavaScript-Funktionen
Hinweise zur Barrierefreiheit
>Sparsam verwenden
Landmark-Rollen dienen dazu, größere Bereiche eines Dokuments zu kennzeichnen. Zu viele Landmark-Rollen können in Screenreadern für „Rauschen“ sorgen und es erschweren, den allgemeinen Aufbau der Seite zu verstehen.
Eingabefelder sind keine Formulare
Sie müssen role="form" nicht für jedes Formularelement (Eingabefelder, Textbereiche, Auswahllisten usw.) deklarieren. Die Rolle sollte dem HTML-Element zugewiesen werden, das die Formularelemente umschließt. Idealerweise verwenden Sie dafür das Element <form> und deklarieren role="form" nicht zusätzlich.
Suche
Wenn ein Formular für die Suche verwendet wird, sollten Sie den spezifischeren Wert role="search" verwenden.
Bewährte Vorgehensweisen
>HTML bevorzugen
Das Element <form> vermittelt automatisch, dass es die Rolle form hat. Verwenden Sie nach Möglichkeit das semantische Element <form> statt der Rolle form.
Landmarks beschriften
Für die Rolle form wird ein zugänglicher Name dringend empfohlen, auch wenn ARIA ihn nicht vorschreibt.
Jedes <form>-Element und jedes Element mit der Rolle form, das als Landmark bereitgestellt werden soll, muss einen zugänglichen Namen erhalten. So können Benutzer assistierender Technologien den Zweck der Formular-Landmark schnell erkennen.
Verwenden Sie aria-labelledby, aria-label oder title auf demselben Element, dem Sie role="form" zugewiesen haben, um ihm einen zugänglichen Namen zu geben.
role="form" verwenden
<div role="form" id="gift-cards" aria-label="Purchase a gift card">
<!-- form content -->
</div>
Redundante Beschreibungen
Screenreader geben den Rollentyp einer Landmark bekannt. Daher müssen Sie die Art der Landmark nicht in ihrer Beschriftung wiederholen. Beispielsweise kann role="form" mit aria-label="Contact form" redundant als „contact form form“ ausgegeben werden.
Beispiele
<div role="form" id="send-comment" aria-label="Add a comment">
<label for="username">Username</label>
<input
id="username"
name="username"
autocomplete="nickname"
autocorrect="off"
type="text" />
<label for="email">Email</label>
<input
id="email"
name="email"
autocomplete="email"
autocapitalize="off"
autocorrect="off"
spellcheck="false"
type="text" />
<label for="comment">Comment</label>
<textarea id="comment" name="comment"></textarea>
<input value="Comment" type="submit" />
</div>
Es wird empfohlen, stattdessen <form> zu verwenden.
<form id="send-comment" aria-label="Add a comment">…</form>
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # form> |
| Unknown specification> |