Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

aria-controls — identificar los elementos controlados

`aria-controls` relaciona un control con los elementos cuyo contenido o visibilidad gestiona.

Versión: WAI-ARIA 1.2

Sintaxis

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

Su valor es una lista de identificadores de elementos separados por espacios. Cada identificador debe resolver al elemento correcto y único del documento. Se admiten varios destinos cuando un control realmente los gestiona.

Es una relación para tecnologías de apoyo: no mueve elementos, no establece su propiedad ni instala manejadores de eventos. Tampoco modifica automáticamente el foco o la visibilidad. La función prevista debe poder utilizarse con un teclado normal.

El botón del ejemplo controla una lista de resultados y su contador. Su manejador añade CSS y actualiza el contador. La prueba comprueba ambos elementos modificados y dos relaciones resueltas en el árbol de accesibilidad; no supone que todos los lectores ofrezcan un atajo especial hacia esos destinos.

Ejemplos

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

Se verificaron los cambios reales de lista y contador junto con las relaciones de control resueltas.

Fuentes