CKTIS / JavaScript
ARIA-Zustände für Fehler und Ausblendung sowie Fokussteuerung mit tabindex
Melde Validierungsfehler, blende dekorative Inhalte für assistive Technologien aus und verschiebe den Fokus, ohne einen zusätzlichen Tabstopp einzufügen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
HTML attributes: aria-invalid="true|false|grammar|spelling"; aria-hidden="true|false"; aria-errormessage="message-id"; hidden; tabindex="integer".
JavaScript DOM: control.setAttribute("aria-invalid", "true"); control.removeAttribute("aria-invalid"); message.hidden = false; message.tabIndex = -1; message.focus(); document.activeElement === message.aria-invalid meldet das Ergebnis einer Validierung an assistive Technologien; das Attribut prüft den Wert nicht selbst und verhindert das Absenden nicht. Setze es bei einem erkannten Fehler auf "true". Bei einem leeren Pflichtfeld warte bis zu einem Absendeversuch. Nach der Korrektur entfernst du das Attribut oder setzt es auf den Standardwert "false". "grammar" und "spelling" kennzeichnen Grammatik- bzw. Rechtschreibfehler. Bei "true" kannst du über aria-errormessage eine sichtbare Korrekturanleitung anhand ihrer ID verknüpfen.
aria-hidden="true" schließt ein Element samt Nachfahren aus dem Barrierefreiheitsbaum aus, ohne es visuell auszublenden oder den Fokus zu unterbinden. Nutze es für dekorative oder redundante Inhalte, nie für fokussierbare Elemente oder deren Vorfahren. aria-hidden="false" hebt die Ausblendung durch einen Vorfahren nicht auf. Um eine gewöhnliche Meldung für alle auszublenden, setze message.hidden = true; mit false blendest du sie wieder ein.
Die DOM-Eigenschaft tabIndex entspricht dem HTML-Attribut tabindex. Ohne das Attribut behalten native Steuerelemente ihr übliches Fokusverhalten. 0 nimmt ein Element in die normale Reihenfolge auf, meist gemäß der Dokumentreihenfolge. -1 erlaubt focus(), überspringt das Element aber normalerweise bei der Tab-Navigation. Vermeide positive Werte: Im selben Fokusnavigationsbereich stellen sie Elemente nach aufsteigendem Zahlenwert vor die gewöhnlichen Tabstopps. Browser- und Systemeinstellungen können die Reihenfolge beeinflussen.
Blende das Ziel ein, bevor du focus() aufrufst. Wenn du ein fokussiertes Element ausblendest, verschiebe den Fokus zuerst an eine sinnvolle Stelle. Im Beispiel umgeht noValidate die automatische Prüfung beim Absenden; validity.valueMissing erkennt das leere Pflichtfeld weiterhin. Das sind Funktionen der Webplattform, nicht von ECMAScript. document.activeElement zeigt den DOM-Fokus, nicht die Ansage eines Screenreaders.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Form validation and focus</title>
</head>
<body>
<script>
(() => {
const form = document.createElement('form');
form.noValidate = true;
const input = document.createElement('input');
input.required = true;
const label = document.createElement('label');
label.append('Name ', input);
const error = document.createElement('p');
error.id = 'ck-focus-name-error';
error.textContent = 'Enter your name.';
error.hidden = true;
error.tabIndex = -1;
const submit = document.createElement('button');
submit.type = 'submit';
const decoration = document.createElement('span');
decoration.textContent = ' →';
decoration.setAttribute('aria-hidden', 'true');
submit.append('Submit', decoration);
function clearError() {
input.removeAttribute('aria-invalid');
input.removeAttribute('aria-errormessage');
error.hidden = true;
}
input.addEventListener('input', () => {
if (!input.validity.valueMissing) clearError();
});
form.addEventListener('submit', (event) => {
event.preventDefault();
if (input.validity.valueMissing) {
error.hidden = false;
input.setAttribute('aria-invalid', 'true');
input.setAttribute('aria-errormessage', error.id);
error.focus();
} else {
clearError();
}
console.log(`aria-invalid=${input.getAttribute('aria-invalid')}; hidden=${error.hidden}; errorFocused=${document.activeElement === error}`);
});
form.append(error, label, ' ', submit);
document.body.append(form);
})();
</script>
</body>
</html>Ergebnis
aria-invalid=true; hidden=false; errorFocused=true aria-invalid=null; hidden=true; errorFocused=false
Speichere das Beispiel als `example.html` und öffne die Datei im Browser. In der Entwicklerkonsole siehst du die ausgegebenen Zeilen. Klicke bei leerem Feld `Name` auf `Submit`: Die Fehlermeldung erscheint und erhält den Fokus. Drücke auf der Seite Tab, gib `Ada` in `Name` ein und klicke erneut auf `Submit`. Die Meldung verschwindet bei der Eingabe, und das Formular sendet keine Daten. Der Pfeil bleibt sichtbar, gehört aber nicht zum zugänglichen Namen der Schaltfläche.
Zugehörige Lektionen
- JavaScript · Lektion 23 · Mittlere Stufe · Version: 3