CKTIS / HTML
aria-controls — identificar elementos controlados
`aria-controls` liga um controlo aos elementos cujo conteúdo ou visibilidade gere.
Versão: WAI-ARIA 1.2
Sintaxe
<button aria-controls="results count">Add result</button>O valor é uma lista de identificadores de elementos separados por espaços. Cada identificador deve corresponder ao elemento correto e único no documento. Vários destinos são válidos quando um controlo realmente os gere.
É uma relação para tecnologias de apoio: não move elementos, não estabelece a sua pertença e não instala tratamento de eventos. Também não altera automaticamente foco ou visibilidade. A função pretendida deve funcionar com um teclado normal.
O botão do exemplo controla uma lista de resultados e a respetiva contagem. O seu tratamento acrescenta CSS e atualiza a contagem. O teste verifica ambos os elementos alterados e duas relações resolvidas na árvore de acessibilidade; não pressupõe que cada leitor ofereça um atalho especial para esses destinos.
Exemplos
<!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>Resultado
items=2; count=2 results
Verificaram-se alterações reais na lista e na contagem, juntamente com as relações de controlo resolvidas.