¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 4.1.2Nivel ARobusto

Acordeón accesible: botones, encabezados y estado

También llamado: Secciones plegables accesibles, Acordeón de preguntas frecuentes, Widget de mostrar y ocultar (disclosure), Secciones desplegables

Definición

Un acordeón accesible es un conjunto de secciones plegables cuyas cabeceras son botones dentro de encabezados, muestran si están desplegadas o plegadas con aria-expanded y se pueden abrir con el teclado. Los acordeones personalizados entran en el criterio WCAG 4.1.2 Nombre, función, valor, de nivel A.

Un acordeón accesible permite a todos los visitantes abrir y cerrar sus secciones, con el ratón, con el teclado o con un lector de pantalla. Los acordeones están en todas partes: páginas de preguntas frecuentes, fichas de producto, menús móviles, ajustes de cookies. Con demasiada frecuencia la cabecera en la que se hace clic es un div con un controlador de clic: los usuarios de teclado no pueden abrirla y los usuarios de lector de pantalla nunca se enteran de que detrás hay más contenido oculto.

Qué significa

Un acordeón creado con script es un componente personalizado, así que le afecta el criterio WCAG 4.1.2 Nombre, función, valor (nivel A): su nombre, función y valor deben poder determinarse por software y los cambios de estado deben llegar a las tecnologías de apoyo. El W3C cita expresamente como ejemplo los widgets de mostrar y ocultar (disclosure). El patrón de acordeón de la guía WAI-ARIA Authoring Practices describe la estructura:

Parte Qué necesita
Cabecera Un button que sea el único elemento dentro de un encabezado (un h2, h3… que encaje en la estructura de encabezados de la página)
Estado aria-expanded="true" cuando el panel es visible, "false" cuando está oculto
Relación con el panel aria-controls con el ID del panel
Panel (opcional) role="region" con aria-labelledby que apunte a su botón; evítelo cuando puedan estar abiertos muchos paneles a la vez (más de 6, aproximadamente), para que la página no se llene de regiones
Panel que no se puede cerrar aria-disabled="true" en su botón, si el acordeón no permite plegar un panel abierto

Teclado: Intro o Espacio abre o cierra el panel de la cabecera que tiene el foco. Tab y Mayús + Tab recorren todos los elementos que pueden recibir el foco, incluido el contenido de los paneles abiertos.

Ejemplos

Ejemplo
<h3>
  <button type="button" id="acc-1" aria-expanded="false"
          aria-controls="acc-panel-1">
    How long does shipping take?
  </button>
</h3>
<div id="acc-panel-1" role="region" aria-labelledby="acc-1" hidden>
  <p>Orders within Austria arrive in 2–3 working days.</p>
</div>

El script alterna aria-expanded y hidden a la vez. Un lector de pantalla anuncia algo como «How long does shipping take?, botón, contraído, encabezado de nivel 3»: la persona sabe qué es, que se puede abrir y dónde se sitúa en el esquema de la página. Como es un <button> real, la navegación por teclado funciona sin código adicional.

Qué hacer

Ponga un botón real dentro de un encabezado, mantenga aria-expanded sincronizado con lo que se muestra, oculte los paneles cerrados con hidden o display: none y muestre un contorno de foco bien visible en las cabeceras.

Qué evitar

Hacer clicable un div o el propio encabezado, mostrar el estado solo con una flecha que gira, usar estados como aria-selected que un botón no puede tener, u ocultar los paneles cerrados solo de forma visual, de modo que los lectores de pantalla aún los lean.

Cómo comprobar un acordeón accesible

    Preguntas frecuentes

    ¿Cómo se hace accesible un acordeón?

    Use un <button> dentro de un encabezado para cada cabecera, ponga aria-expanded en true o false, vincule el botón con su panel mediante aria-controls y oculte los paneles cerrados con hidden. El navegador se encarga entonces del teclado.

    ¿Las cabeceras de un acordeón deben ser encabezados o botones?

    Ambas cosas: el patrón del W3C pone el botón dentro de un encabezado. El encabezado permite saltar entre secciones y el botón permite abrirlas y cerrarlas.

    ¿Puedo usar details y summary para un acordeón?

    Sí, para secciones desplegables sencillas <details> y <summary> son accesibles de serie. Si necesita que solo se abra un panel a la vez o animaciones personalizadas, el patrón de acordeón ARIA le da más control.

    ¿Un acordeón necesita navegación con las teclas de flecha?

    No es obligatorio. Intro, Espacio y la tecla Tab son el núcleo del patrón del W3C para las cabeceras de un acordeón; moverse entre cabeceras con las flechas es un extra opcional. En las pestañas, en cambio, las teclas de flecha son lo esperado.

    ¿Son buenos los acordeones para las páginas de preguntas frecuentes?

    Mantienen cortas las páginas largas, pero las respuestas ocultas pasan fácilmente desapercibidas. Ayudan los encabezados de pregunta claros y también la opción de abrir todas las secciones a la vez en las páginas de preguntas frecuentes largas.

    • Nombre, función, valor: controles para lectores de pantalla

      Nombre, función, valor es el criterio de conformidad WCAG 4.1.2: en todos los componentes de la interfaz de usuario, el nombre y el rol pueden determinarse por software, los estados, las propiedades y los valores que el usuario puede establecer pueden definirse por software y los cambios se notifican a las tecnologías de apoyo. Es de nivel A.

      Leer la definición: Nombre, función, valor: controles para lectores de pantalla
    • Estructura de encabezados: un esquema de página claro

      La estructura de encabezados es el esquema que forma una página con sus elementos h1 a h6. Cada encabezado marca el inicio de una sección, y su nivel indica el lugar que ocupa esa sección en la jerarquía.

      Leer la definición: Estructura de encabezados: un esquema de página claro
    • Navegación por teclado: criterio WCAG 2.1.1 explicado

      La navegación por teclado significa que todas las funciones de un sitio web se pueden alcanzar y utilizar solo con un teclado, normalmente con Tab, Mayús+Tab, Intro, Espacio y las teclas de flecha. El criterio WCAG 2.1.1 lo exige en el nivel A.

      Leer la definición: Navegación por teclado: criterio WCAG 2.1.1 explicado
    • Pestañas accesibles: roles ARIA y teclas de flecha

      Las pestañas accesibles son una interfaz de pestañas cuyas pestañas se exponen como una lista de pestañas con estado de selección, se manejan con el teclado y están conectadas con el panel que muestran. Entran en el criterio WCAG 4.1.2 Nombre, función, valor, de nivel A, porque los widgets de pestañas personalizados deben comunicar su rol y su estado a las tecnologías de apoyo.

      Leer la definición: Pestañas accesibles: roles ARIA y teclas de flecha

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo