CKTIS / HTML
aria-controls — určení ovládaných prvků
`aria-controls` propojuje ovládací prvek s prvky, jejichž obsah nebo viditelnost řídí.
Verze: WAI-ARIA 1.2
Syntaxe
<button aria-controls="results count">Add result</button>Hodnotou je seznam identifikátorů oddělených mezerami. Každý má ukazovat na správný jednoznačný prvek dokumentu. Více cílů je přípustných, pokud je ovládací prvek skutečně řídí.
Jde o vztah pro pomocné technologie: nepřesouvá prvky, neurčuje vlastnictví ani nepřidává obsluhu událostí. Automaticky nemění fokus ani viditelnost. Zamýšlená funkce musí být ovladatelná běžnou klávesnicí.
Tlačítko v příkladu ovládá seznam výsledků a jejich počet. Obsluha přidá CSS a aktualizuje počet. Test kontroluje oba změněné prvky i dvě rozpoznané vazby ve stromu přístupnosti; nepředpokládá speciální klávesovou zkratku každé čtečky k těmto cílům.
Příklady
<!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>Výsledek
items=2; count=2 results
Ověřena je skutečná změna seznamu a počtu i správné vazby ovládání.