CKTIS / JavaScript
ARIA voor ongeldige en verborgen inhoud en focusbeheer met tabindex
Meld validatiefouten, verberg decoratieve inhoud voor hulptechnologie en verplaats de toetsenbordfocus zonder een extra stop aan de tabvolgorde toe te voegen.
Versie: 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 geeft het resultaat van validatie door aan hulptechnologie; het controleert zelf geen waarde en blokkeert het verzenden niet. Zet het op "true" als de validatie een fout vindt, maar wacht bij een leeg verplicht veld op een verzendpoging. Verwijder het attribuut na correctie of zet het op de standaardwaarde "false". "grammar" en "spelling" geven respectievelijk grammatica- en spelfouten aan. Met "true" kun je via aria-errormessage de ID van een zichtbaar herstelbericht aan het veld koppelen.
aria-hidden="true" sluit een element en zijn afstammelingen uit van de toegankelijkheidsboom zonder ze visueel te verbergen of focus onmogelijk te maken. Gebruik het voor decoratieve of overbodige inhoud, nooit op een focusbaar element of een voorouder daarvan. aria-hidden="false" maakt het verbergen door een voorouder niet ongedaan. Verberg een gewoon bericht voor iedereen met message.hidden = true; gebruik false om het te tonen.
De DOM-eigenschap tabIndex komt overeen met het HTML-attribuut tabindex. Zonder het attribuut behouden ingebouwde bedieningselementen hun standaard focusgedrag. 0 neemt het element op in de normale volgorde, meestal de documentvolgorde. -1 maakt focus() mogelijk, maar slaat het element normaal over bij navigatie met Tab. Vermijd positieve waarden: binnen hetzelfde bereik voor focusnavigatie plaatsen ze elementen vóór de gebruikelijke stops, in oplopende numerieke volgorde. Instellingen van de browser en het systeem kunnen de volgorde beïnvloeden.
Toon het doel voordat je focus() aanroept. Verplaats de focus eerst naar een nuttige plek als je een element met focus wilt verbergen. In het voorbeeld slaat noValidate de automatische validatie bij verzending over, maar validity.valueMissing detecteert nog steeds het lege verplichte veld. Dit zijn functies van het webplatform, niet van ECMAScript. document.activeElement controleert de DOM-focus, niet wat een schermlezer aankondigt.
Voorbeelden
<!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>Resultaat
aria-invalid=true; hidden=false; errorFocused=true aria-invalid=null; hidden=true; errorFocused=false
Sla het voorbeeld op als `example.html` en open het in een browser. Open de ontwikkelaarsconsole om de uitvoerregels te zien. Klik op `Submit` terwijl `Name` leeg is: de foutmelding verschijnt en krijgt focus. Druk op de pagina op Tab, typ `Ada` in `Name` en klik opnieuw op `Submit`. De melding verdwijnt zodra je een waarde invoert en het formulier verzendt geen gegevens. De pijl blijft zichtbaar en draagt niet bij aan de toegankelijke naam van de knop.
Gerelateerde lessen
- JavaScript · Les 23 · Gemiddeld · Versie: 3