Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 id oder eine durch Leerzeichen getrennte Liste von id-Werten der Elemente, die die Fehlermeldung für das aktuelle Element enthalten.

Zugehörige Schnittstellen

Element.ariaErrorMessageElements

Die Eigenschaft ariaErrorMessageElements ist Teil der Schnittstelle jedes Elements. Ihr Wert ist ein Array von Unterklassen von Element, die den id-Referenzen im Attribut aria-errormessage entsprechen (mit einigen Einschränkungen).

ElementInternals.ariaErrorMessageElements

Die Eigenschaft ariaErrorMessageElements ist Teil der Schnittstelle jedes benutzerdefinierten Elements. Ihr Wert ist ein Array von Unterklassen von Element, die den id-Referenzen im Attribut aria-errormessage entsprechen (mit einigen Einschränkungen).

Zugehörige Rollen

Wird in folgenden Rollen verwendet:

Von folgenden Rollen geerbt:

Beispiel

Wir erstellen einige CSS-Regeln, um:

  1. alle Fehlermeldungen auszublenden,
  2. ungültige Objekte als ungültig darzustellen und
  3. Fehlermeldungen anzuzeigen, die als Geschwisterelemente auf ein ungültiges Objekt folgen.

Mit aria-invalid="true" kennzeichnen wir ungültige Objekte:

css
.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.

html
<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