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
<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.
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.
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.
Términos relacionados
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 pantallaEstructura 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 claroNavegació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 explicadoPestañ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