Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

aria-controls — indicare gli elementi controllati

`aria-controls` collega un controllo agli elementi di cui gestisce contenuto o visibilità.

Versione: WAI-ARIA 1.2

Sintassi

<button aria-controls="results count">Add result</button>

Il valore è un elenco di identificatori di elementi separati da spazi. Ogni identificatore deve risolvere all’elemento corretto e univoco del documento. Più destinazioni sono ammesse quando un controllo le gestisce realmente.

È una relazione per le tecnologie assistive: non sposta elementi, non ne stabilisce l’appartenenza e non installa gestori di eventi. Non modifica automaticamente neppure focus o visibilità. La funzione prevista deve essere utilizzabile con una normale tastiera.

Il pulsante dell’esempio controlla una lista di risultati e il loro contatore. Il gestore aggiunge CSS e aggiorna il conteggio. Il test verifica entrambi gli elementi modificati e due relazioni risolte nell’albero di accessibilità; non presume che ogni lettore offra una scorciatoia speciale verso quelle destinazioni.

Esempi

<!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>

Risultato

items=2; count=2 results

Verificate le modifiche effettive a lista e contatore insieme alle relazioni di controllo risolte.

Fonti