CKTIS / HTML
aria-controls — bestuurde elementen aanwijzen
`aria-controls` verbindt een bedieningselement met elementen waarvan het de inhoud of zichtbaarheid bestuurt.
Versie: WAI-ARIA 1.2
Syntax
<button aria-controls="results count">Add result</button>De waarde is een door spaties gescheiden lijst van elementidentificaties. Elke identificatie moet naar het juiste unieke element in het document verwijzen. Meerdere doelen zijn geldig wanneer één bedieningselement ze daadwerkelijk bestuurt.
Dit is een relatie voor hulptechnologie: ze verplaatst geen elementen, bepaalt geen eigendom en installeert geen gebeurtenisafhandeling. Ook focus of zichtbaarheid verandert niet automatisch. De beoogde functie moet met een gewoon toetsenbord werken.
De voorbeeldknop bestuurt een resultatenlijst en de teller ervan. De afhandeling voegt CSS toe en werkt de teller bij. De test controleert beide gewijzigde elementen en twee opgeloste relaties in de toegankelijkheidsboom; hij neemt niet aan dat iedere schermlezer een speciale sneltoets naar die doelen biedt.
Voorbeelden
<!doctype html><meta charset="utf-8">
<button id="add" aria-controls="results count">Add result</button>
<ul id="results"><li>HTML</li></ul><p id="count">1 result</p>
<output id="result"></output>
<script>
document.querySelector('#add').addEventListener('click', () => {
const item = document.createElement('li'); item.textContent = 'CSS';
document.querySelector('#results').append(item);
document.querySelector('#count').textContent = document.querySelector('#results').children.length + ' results';
});
document.querySelector('#add').click();
document.querySelector('#result').textContent = 'items=' + document.querySelector('#results').children.length + '; count=' + document.querySelector('#count').textContent;
</script>Resultaat
items=2; count=2 results
Daadwerkelijke lijst- en tellerwijzigingen en correct opgeloste besturingsrelaties zijn gecontroleerd.