Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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í.

Zdroje