CKTIS / HTML
aria-controls — povezivanje upravljanih elemenata
`aria-controls` povezuje kontrolu s elementima čijim sadržajem ili vidljivošću upravlja.
Verzija: WAI-ARIA 1.2
Sintaksa
<button aria-controls="results count">Add result</button>Vrijednost je popis identifikatora elemenata odvojenih razmacima. Svaki treba pokazivati na ispravan jedinstven element dokumenta. Više ciljeva dopušteno je kada njima ista kontrola doista upravlja.
To je odnos za pomoćne tehnologije: ne premješta elemente, ne određuje vlasništvo i ne instalira obradu događaja. Također ne mijenja fokus ili vidljivost automatski. Predviđena funkcija mora raditi običnom tipkovnicom.
Gumb u primjeru upravlja popisom rezultata i njihovim brojem. Obrada dodaje CSS i ažurira broj. Test provjerava oba promijenjena elementa i dvije razriješene veze u stablu pristupačnosti; ne pretpostavlja da svaki čitač daje poseban prečac do tih ciljeva.
Primjeri
<!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>Rezultat
items=2; count=2 results
Provjerene su stvarne promjene popisa i broja te pravilno razriješeni odnosi upravljanja.