ARIA: aria-required-Attribut
Das Attribut aria-required gibt an, dass für ein Element eine Benutzereingabe erforderlich ist, bevor ein Formular abgeschickt werden kann.
Beschreibung
Wenn ein semantisches HTML-Element wie <input>, <select> oder <textarea> einen Wert haben muss, sollte es mit dem Attribut required versehen werden. Das HTML-Attribut required verhindert das Abschicken des Formulars, solange die erforderlichen Formularsteuerelemente keine gültigen Werte haben. Zugleich stellt es sicher, dass Personen, die unterstützende Technologien verwenden, erkennen können, welche semantischen Formularsteuerelemente gültige Inhalte benötigen.
Wenn Formularsteuerelemente mit nicht semantischen Elementen erstellt werden, etwa mit einem <div> mit der Rolle checkbox, sollte das Attribut aria-required mit dem Wert true hinzugefügt werden. So wird unterstützenden Technologien mitgeteilt, dass für dieses Element eine Benutzereingabe erforderlich ist, damit das Formular abgeschickt werden kann. Das Attribut aria-required kann auch mit HTML-Formularelementen verwendet werden; es ist nicht auf Elemente beschränkt, denen eine ARIA-Rolle zugewiesen wurde.
Ähnlich wie das HTML-Attribut required bei semantischen HTML-Formularsteuerelementen vermittelt aria-required unterstützenden Technologien ausdrücklich, dass für das Element eine Eingabe erforderlich ist, bevor das Formular abgeschickt werden kann. Das Attribut required auf einem semantischen HTML-Formularsteuerelement verhindert das Abschicken des Formulars, wenn kein Wert vorhanden ist. In manchen Browsern wird dabei eine integrierte Fehlermeldung angezeigt, wenn beim Versuch, das Formular abzuschicken, ein erforderlicher Wert ungültig ist. Das Attribut aria-required hat wie alle ARIA-Zustände und -Eigenschaften keinen Einfluss auf die Funktionalität des Elements. Funktionalität und Verhalten müssen mit JavaScript hinzugefügt werden.
Hinweis: ARIA verändert nur den Barrierefreiheitsbaum und damit, wie unterstützende Technologien Inhalte für Benutzer darstellen. ARIA ändert nichts an der Funktion oder dem Verhalten eines Elements. Wenn Sie semantische HTML-Elemente nicht für ihren vorgesehenen Zweck und mit ihrer Standardfunktionalität verwenden, müssen Sie Verhalten, Fokus und ARIA-Zustände mit JavaScript verwalten.
Die CSS-Pseudoklassen :required und :optional erfassen <input>-, <select>- und <textarea>-Elemente danach, ob sie erforderlich beziehungsweise optional sind. Wenn Sie nicht semantische Elemente als Formularsteuerelemente verwenden, können Sie diese CSS-Pseudoklassen nicht nutzen. Sofern das Attribut vorhanden ist, können Sie jedoch Attributselektoren verwenden: [aria-required="true"] oder [aria-required="false"].
Wenn ein Formular sowohl erforderliche als auch optionale Formularelemente enthält, sollten die erforderlichen Elemente visuell gekennzeichnet werden, ohne dass die Bedeutung allein durch Farbe vermittelt wird. Üblicherweise werden dafür ein beschreibender Text und/oder ein Symbol verwendet.
Hinweis: Welche Elemente erforderlich sind, sollte für alle Benutzer erkennbar sein. Stellen Sie sicher, dass die visuelle Darstellung erforderliche Formularsteuerelemente einheitlich und deutlich kennzeichnet. Farbe allein reicht nicht aus, um diese Information zu vermitteln.
Werte
Zugehörige Schnittstellen
Element.ariaRequired-
Die Eigenschaft
ariaRequiredder SchnittstelleElementspiegelt den Wert des Attributsaria-requiredwider. ElementInternals.ariaRequired-
Die Eigenschaft
ariaRequiredder SchnittstelleElementInternalsspiegelt den Wert des Attributsaria-requiredwider.
Zugehörige Rollen
Wird in folgenden Rollen verwendet:
Wird an folgende Rollen vererbt:
Beispiele
Das Attribut sollte dem Element mit der Rolle des Formularsteuerelements hinzugefügt werden. Wenn Benutzer eine E-Mail-Adresse in ein textbox-Element eingeben müssen, fügen Sie aria-required="true" zu diesem Element hinzu.
<div id="tbLabel">Email Address *</div>
<div
role="textbox"
contenteditable
aria-labelledby="tblabel"
aria-required="true"
id="email1"></div>
Hinweis:
Wenn die Beschriftung des Felds bereits das Wort „erforderlich“ enthält, wird empfohlen, das Attribut aria-required wegzulassen. So wird vermieden, dass Screenreader den Begriff „erforderlich“ zweimal vorlesen.
In diesem Beispiel muss JavaScript verwendet werden, um das Abschicken des umgebenden Formulars zu verhindern, wenn das Textfeld leer ist.
Dies lässt sich auch semantisch und ohne JavaScript umsetzen:
<label for="email1">Email Address (required)</label>
<input type="email" id="email1" required />
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-required> |