Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes