CKTIS / HTML
aria-controls — identifier les éléments contrôlés
`aria-controls` relie un contrôle aux éléments dont il gère le contenu ou la visibilité.
Version : WAI-ARIA 1.2
Syntaxe
<button aria-controls="results count">Add result</button>La valeur est une liste d’identifiants d’éléments séparés par des espaces. Chaque identifiant doit désigner le bon élément, identifié sans ambiguïté dans le document. Plusieurs cibles sont valides lorsqu’un contrôle les gère effectivement.
C’est une relation pour les technologies d’assistance : elle ne déplace pas les éléments, ne définit pas leur appartenance et n’installe aucun gestionnaire d’événement. Elle ne modifie automatiquement ni focus ni visibilité. La fonction attendue doit fonctionner avec un clavier ordinaire.
Le bouton de l’exemple contrôle une liste de résultats et leur compteur. Son gestionnaire ajoute CSS et actualise le compteur. Le test vérifie les deux éléments modifiés et deux relations résolues dans l’arbre d’accessibilité ; il ne suppose pas que chaque lecteur offre un raccourci spécial vers ces cibles.
Exemples
<!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>Résultat
items=2; count=2 results
Les modifications réelles de la liste et du compteur ainsi que les relations de contrôle résolues ont été vérifiées.