CKTIS / JavaScript
Toegankelijke interacties in JavaScript
Een toegankelijke interactie combineert toetsenbordbediening, voorspelbare focus en een toestand die hulptechnologie kan begrijpen. JavaScript moet de zichtbaarheid met ARIA synchroniseren en updates communiceren zonder de focus onnodig te verplaatsen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;Met een toegankelijke interactie kunnen mensen een interface zonder muis bedienen en veranderingen begrijpen met hulp van hulptechnologie. Begin met native knoppen: die bieden semantiek en activering via het toetsenbord. ARIA beschrijft de interface, maar voegt zelf geen gedrag toe. De ECMAScript-specificatie beschrijft de taal en onderscheidt die van de hostomgeving; de meegeleverde bron definieert DOM, HTML en ARIA niet.
Beheer van de ARIA-status en toetsenbordfocus betekent dat toestand, zichtbaarheid en focus op elkaar worden afgestemd. In het voorbeeld komt aria-expanded overeen met de omgekeerde waarde van panel.hidden, terwijl aria-controls verwijst naar panel. In de openingstest staat de focus al op de knop Details en blijft die daar; het paneel is geen modaal dialoogvenster. De eventhandler van Close details zet de focus op Details voordat het paneel wordt verborgen. Wordt het paneel met Details gesloten terwijl de focus nog in het paneel staat, dan zet setExpanded de focus terug op Details voordat het paneel wordt verborgen. De consoletest controleert beide manieren van sluiten, ook het activeren van Details zonder de focus eerst naar die knop te verplaatsen. Verwijder de zichtbare focusindicator niet en gebruik geen positieve tabindex-waarden om de navigatievolgorde te herstellen.
Aankondigingen uit ARIA-live-regio’s communiceren updates zonder de focus te verplaatsen. Het voorbeeld werkt textContent bij in een bestaande regio met role="status". Die rol heeft impliciet het gedrag van aria-live="polite"; de HTML stelt geen aria-live-attribuut in. Het attribuut aria-atomic="true" geeft aan dat de volledige inhoud van de regio als bericht moet worden behandeld. De regio bestaat al vóór de update. Gebruik deze niet in plaats van bedieningslabels en kondig niet elke kleine wijziging aan. De exacte woorden en het moment van de aankondiging zijn afhankelijk van de browser en hulptechnologie.
Sla het voorbeeld op als HTML-bestand en controleer toetsenbordbediening, attribuutwaarden en aankondigingen van de schermlezer. De verwachte uitvoer beschrijft de DOM-toestand en waar de focus staat, maar garandeert niet wat de schermlezer uitspreekt. Het voorbeeld is uitgevoerd in een geïsoleerde Chromium-omgeving en de console-uitvoer kwam exact overeen met de verwachte uitvoer. Het gebruikt ECMAScript 2015-syntaxis en browserinterfaces; ondersteuning in de doelomgeving moet afzonderlijk worden gecontroleerd. Node 24 in de repository bewijst niet dat deze interfaces worden ondersteund.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Accessible disclosure</title>
</head>
<body>
<button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" aria-label="Details" hidden>
<p>Additional information.</p>
<button id="close" type="button">Close details</button>
</section>
<p id="status" role="status" aria-atomic="true"></p>
<script>
const toggle = document.getElementById('toggle');
const panel = document.getElementById('panel');
const closeButton = document.getElementById('close');
const statusMessage = document.getElementById('status');
function setExpanded(expanded) {
if (!expanded && panel.contains(document.activeElement)) {
toggle.focus();
}
panel.hidden = !expanded;
toggle.setAttribute('aria-expanded', String(expanded));
statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
}
toggle.addEventListener('click', () => setExpanded(panel.hidden));
closeButton.addEventListener('click', () => {
toggle.focus();
setExpanded(false);
});
function report(step) {
console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
}
report('Initial');
toggle.focus();
toggle.click();
report('Open');
console.log('Open kept focus on Details: ' + (document.activeElement === toggle));
// Test closing when activation does not first focus the close button.
toggle.blur();
console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
closeButton.click();
report('Close');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
// Test closing with Details while focus remains inside the panel.
toggle.click();
closeButton.focus();
console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
toggle.click();
report('Close with Details');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
</script>
</body>
</html>Resultaat
Initial: hidden=true; aria-expanded=false; status="" Open: hidden=false; aria-expanded=true; status="Details opened." Open kept focus on Details: true Focus inside panel before close: false Close: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true Focus inside panel before closing with Details: true Close with Details: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true
De test activeert `Details` programmatisch terwijl de focus op `Close details` staat. De focus hoort terug te gaan naar `Details` voordat het paneel wordt verborgen.