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

CKTIS / HTML

aria-expanded — estado expandido o contraído

`aria-expanded` informa de si el contenido controlado está expandido y debe coincidir con el estado real de la interfaz.

Versión: WAI-ARIA 1.2

Sintaxis

<button aria-expanded="false" aria-controls="panel">Details</button>

En el botón que despliega contenido, asigna las cadenas true o false. La ausencia de estado significa que el elemento no declara capacidad de expansión. No asignes un estado contraído a todos los nodos hoja de un árbol.

Coloca el atributo en el control, no solo en el panel mostrado. El destino puede identificarse mediante aria-controls. Cambiar el estado por sí solo no muestra contenido ni aporta comportamiento de clic, teclado o foco.

El ejemplo conecta un botón nativo con un panel oculto. Una función actualiza conjuntamente visibilidad y estado, evitando discrepancias tras la activación. La prueba comprueba el panel visible y el estado expandido del árbol de accesibilidad. Otra activación utiliza la misma función para contraerlo.

Ejemplos

<!doctype html><meta charset="utf-8">
<button id="toggle" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" hidden><h2>Course details</h2><p>Three short lessons.</p></section>
<output id="result"></output>
<script>
const button = document.querySelector('#toggle'), panel = document.querySelector('#panel');
button.addEventListener('click', () => {
  const expanded = button.getAttribute('aria-expanded') !== 'true';
  panel.hidden = !expanded;
  button.setAttribute('aria-expanded', String(expanded));
});
button.click();
document.querySelector('#result').textContent = 'expanded=' + button.getAttribute('aria-expanded') + '; visible=' + !panel.hidden;
</script>

Resultado

expanded=true; visible=true

El resultado confirma la apertura real del panel con una semántica de accesibilidad coherente.

Fuentes