ARIA: Attribut aria-errormessage
Das Attribut aria-errormessage eines Objekts gibt das Element oder die Elemente an, die eine Fehlermeldung für dieses Objekt bereitstellen.
Beschreibung
Wenn durch eine Benutzereingabe ein Fehler entsteht, sollten Sie die Benutzer darüber informieren und ihnen erklären, wie sie ihn beheben können. Dafür benötigen Sie zwei Attribute: Setzen Sie aria-invalid="true", um das Objekt als fehlerhaft zu kennzeichnen. Fügen Sie anschließend das Attribut aria-errormessage hinzu und setzen Sie dessen Wert auf die id des Elements oder der Elemente, die den Fehlermeldungstext für dieses Objekt enthalten.
Das Attribut aria-errormessage sollte nur verwendet werden, wenn der Wert eines Objekts ungültig ist, also wenn aria-invalid auf true gesetzt ist. Wenn das Objekt gültig ist und Sie das Attribut aria-errormessage dennoch angeben, stellen Sie sicher, dass das referenzierte Element ausgeblendet ist, da seine Meldung dann nicht relevant ist.
Wenn aria-errormessage relevant ist, müssen die referenzierten Elemente sichtbar sein, damit Benutzer die Fehlermeldung sehen oder hören können.
Häufig empfiehlt es sich, das Element mit der Fehlermeldung als ARIA-Live-Region einzurichten, etwa wenn eine Fehlermeldung angezeigt wird, nachdem Benutzer einen ungültigen Wert eingegeben haben. Die Fehlermeldung sollte beschreiben, was falsch ist, und erklären, was erforderlich ist, damit das Objekt gültig wird. Wenn Sie die Fehlermeldung als ARIA-Live-Region hinzufügen, werden unterstützende Technologien darüber informiert, dass der Inhalt der Fehlermeldung für Benutzer hilfreich sein kann, selbst wenn er ihnen andernfalls nicht übermittelt würde.
Fügen Sie eine sichtbare Fehlermeldung hinzu und verknüpfen Sie das ungültige Objekt über das Attribut aria-errormessage mit ihr, wenn der Fehler visuell erkennbar ist und eine ausdrückliche Beschreibung erforderlich ist.
Werte
- Liste von ID-Referenzen
-
Die
idoder eine durch Leerzeichen getrennte Liste vonid-Werten der Elemente, die die Fehlermeldung für das aktuelle Element enthalten.
Zugehörige Schnittstellen
Element.ariaErrorMessageElements-
Die Eigenschaft
ariaErrorMessageElementsist Teil der Schnittstelle jedes Elements. Ihr Wert ist ein Array von Unterklassen vonElement, die denid-Referenzen im Attributaria-errormessageentsprechen (mit einigen Einschränkungen). ElementInternals.ariaErrorMessageElements-
Die Eigenschaft
ariaErrorMessageElementsist Teil der Schnittstelle jedes benutzerdefinierten Elements. Ihr Wert ist ein Array von Unterklassen vonElement, die denid-Referenzen im Attributaria-errormessageentsprechen (mit einigen Einschränkungen).
Zugehörige Rollen
Wird in folgenden Rollen verwendet:
Von folgenden Rollen geerbt:
Beispiel
Wir erstellen einige CSS-Regeln, um:
- alle Fehlermeldungen auszublenden,
- ungültige Objekte als ungültig darzustellen und
- Fehlermeldungen anzuzeigen, die als Geschwisterelemente auf ein ungültiges Objekt folgen.
Mit aria-invalid="true" kennzeichnen wir ungültige Objekte:
.errormessage {
visibility: hidden;
}
[aria-invalid="true"] {
outline: 2px solid red;
}
[aria-invalid="true"] ~ .errormessage {
visibility: visible;
}
Wenn ein Objekt ungültig ist, fügen wir mit JavaScript aria-invalid="true" hinzu. Durch das obige CSS wird das auf ein ungültiges Objekt folgende Element .errormessage sichtbar.
<p>
<label for="email">Email address:</label>
<input
type="email"
name="email"
id="email"
aria-invalid="true"
aria-errormessage="err1" />
<span id="err1" class="errormessage">Error: Enter a valid email address</span>
</p>
Beim Wechsel von gültig zu ungültig wurde in diesem Beispiel mit JavaScript lediglich aria-invalid am E-Mail-Eingabeelement aktualisiert. Da die Fehlermeldung auf das Eingabeelement folgt, sichtbar wird und im Barrierefreiheitsbaum verfügbar ist, können wir das Beispiel einfach halten. Wir hätten auch die Eigenschaft aria-live verwenden oder der Live-Region eine Rolle wie alert zuweisen können.
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-errormessage> |
Siehe auch
- CSS-Pseudoklasse
:invalid aria-invalidaria-describedbyaria-live