Ejemplo de Estructura HTML:

<div class="accordion">
  <div class="accordion-item">
    <h3 class="accordion-header">
      <button class="accordion-button" aria-expanded="false" aria-controls="content-1" id="button-1">
        Título de la Sección 1
      </button>
    </h3>
    <div id="content-1" class="accordion-content" role="region" aria-labelledby="button-1">
      <p>El contenido de la sección 1 va aquí.</p>
    </div>
  </div>
  <div class="accordion-item">
    <h3 class="accordion-header">
      <button class="accordion-button" aria-expanded="false" aria-controls="content-2" id="button-2">
        Título de la Sección 2
      </button>
    </h3>
    <div id="content-2" class="accordion-content" role="region" aria-labelledby="button-2">
      <p>El contenido de la sección 2 va aquí.</p>
    </div>
  </div>
</div>

2. Atributos ARIA para Contenido Dinámico

Los roles y estados de ARIA son cruciales para informar a las tecnologías de asistencia sobre el comportamiento del acordeón.

• `role="button"`: En el elemento interactivo (botón) que alterna el contenido.
• `aria-expanded`: Establézcalo en `true` cuando el panel de contenido es visible y en `false` cuando está oculto. Esto comunica directamente el estado a los lectores de pantalla.
• `aria-controls`: En el botón, haciendo referencia al `id` del panel de contenido que controla. Esto establece un vínculo programático.
• `aria-labelledby`: En el panel de contenido, haciendo referencia al `id` del botón que lo controla. Esto crea un vínculo bidireccional.
• `role="region"`: En el panel de contenido. Esto indica que el contenido es una sección perceptible de la página.
• `aria-hidden`: Aunque se prefiere `aria-expanded` para controlar los estados de visibilidad, `aria-hidden="true"` se puede usar en paneles de contenido que no se muestran actualmente para evitar que sean anunciados por los lectores de pantalla. Sin embargo, es más robusto asegurarse de que el contenido esté correctamente oculto a través de CSS (`display: none;`) o eliminado del árbol de accesibilidad.

Nota sobre `aria-hidden` vs. `display: none`: Usar `display: none;` en CSS elimina eficazmente el elemento del árbol de accesibilidad. Si está mostrando/ocultando contenido dinámicamente usando JavaScript sin `display: none;`, `aria-hidden` se vuelve más importante. Sin embargo, `display: none;` es generalmente el método preferido para ocultar paneles de contenido.

3. Operabilidad por Teclado

Asegúrese de que los usuarios puedan interactuar con el acordeón utilizando comandos de teclado estándar.

• Navegación con Tabulador: Las cabeceras del acordeón deben ser enfocables y aparecer en el orden de tabulación natural de la página.
• Activación: Presionar `Enter` o `Spacebar` en una cabecera de acordeón enfocada debería alternar la visibilidad de su panel de contenido.
• Teclas de Flecha (Opcional pero Recomendado): Para una experiencia más mejorada, considere implementar la navegación con teclas de flecha:
  • `Arrow Down`: Mover el foco a la siguiente cabecera del acordeón.
  • `Arrow Up`: Mover el foco a la cabecera anterior del acordeón.
  • `Home`: Mover el foco a la primera cabecera del acordeón.
  • `End`: Mover el foco a la última cabecera del acordeón.
  • `Arrow Right` (o `Enter`/`Space`): Expandir/colapsar el elemento actual del acordeón.
  • `Arrow Left` (o `Enter`/`Space`): Colapsar el elemento actual del acordeón y mover el foco de vuelta a la cabecera.

4. Indicadores de Foco Visual

Cuando una cabecera de acordeón recibe el foco del teclado, debe tener un indicador visual claro. Los contornos de foco predeterminados del navegador suelen ser suficientes, pero asegúrese de que no sean eliminados por CSS (por ejemplo, `outline: none;`) sin proporcionar un estilo de foco alternativo y muy visible.

Ejemplo de CSS para el foco:

.accordion-button:focus {
  outline: 3px solid blue; /* O un color que cumpla con los requisitos de contraste */
  outline-offset: 2px;
}

5. Visibilidad y Presentación del Contenido

• Estado Predeterminado: Decida si las secciones del acordeón deben estar colapsadas o expandidas por defecto. Para preguntas frecuentes o información densa, a menudo es mejor comenzar colapsado. Para la navegación o resúmenes de características, tener una sección expandida por defecto podría ser útil.
• Señales Visuales: Use señales visuales claras para indicar si una sección está expandida o colapsada. Esto podría ser un ícono (por ejemplo, un signo '+' o '-', una flecha hacia arriba/abajo) que cambia su apariencia. Asegúrese de que estos íconos también sean accesibles (por ejemplo, a través de `aria-label` si no tienen texto).
• Relaciones de Contraste: Asegúrese de que el contenido de texto dentro del acordeón, y los botones de alternancia, cumplan con los requisitos de relación de contraste de WCAG (4.5:1 para texto normal, 3:1 para texto grande). Esto es vital para usuarios con baja visión.
• Sin Pérdida de Contenido: Cuando una sección se expande, asegúrese de que su contenido no se desborde de su contenedor ni oculte otro contenido crítico.

6. Gestionando el Foco al Alternar

Este es un aspecto más avanzado pero crucial para una experiencia fluida.

• Expandir: Cuando un usuario expande una sección, considere mover el foco al primer elemento interactivo dentro del contenido recién revelado. Esto es especialmente importante si el contenido expandido contiene campos de formulario o enlaces.
• Colapsar: Cuando un usuario colapsa una sección, el foco debe regresar a la cabecera del acordeón que se alternó. Esto evita que los usuarios tengan que navegar hacia atrás a través de secciones previamente colapsadas.

La implementación de la gestión del foco generalmente implica JavaScript para capturar y establecer el foco programáticamente.

Implementando Acordeones Accesibles con JavaScript

Aunque el HTML semántico y ARIA son los primeros pasos, a menudo se requiere JavaScript para manejar la alternancia dinámica y potencialmente la gestión del foco. Aquí hay un enfoque conceptual de JavaScript:

// JavaScript conceptual para la funcionalidad del acordeón

document.querySelectorAll('.accordion-button').forEach(button => {
  button.addEventListener('click', () => {
    const controlsId = button.getAttribute('aria-controls');
    const content = document.getElementById(controlsId);

    if (content) {
      const isExpanded = button.getAttribute('aria-expanded') === 'true';
      
      // Alternar el estado de aria-expanded
      button.setAttribute('aria-expanded', !isExpanded);

      // Alternar la visibilidad del contenido (usando CSS para la accesibilidad)
      content.style.display = isExpanded ? 'none' : 'block'; // O usar un cambio de clase

      // Opcional: gestión del foco al expandir
      // if (!isExpanded) {
      //   const firstFocusableElement = content.querySelector('a[href], button, input, [tabindex]');
      //   if (firstFocusableElement) {
      //     firstFocusableElement.focus();
      //   }
      // }
    }
  });

  // Opcional: la navegación por teclado (teclas de flecha, etc.) también se implementaría aquí.
  // Por ejemplo, manejando eventos 'keydown'.
});

// Configuración inicial: ocultar el contenido por defecto y establecer aria-expanded en falso
document.querySelectorAll('.accordion-content').forEach(content => {
  const headerButton = document.getElementById(content.getAttribute('aria-labelledby'));
  if (headerButton) {
    content.style.display = 'none'; // Ocultar contenido inicialmente
    headerButton.setAttribute('aria-expanded', 'false');
  }
});

Consideraciones Importantes para JavaScript:

• CSS para Ocultar: Es una buena práctica usar CSS (por ejemplo, `display: none;` o una clase que establezca `height: 0; overflow: hidden;` para transiciones más suaves) para ocultar el contenido. Esto asegura que el contenido se elimine del árbol de accesibilidad cuando no es visible.
• Degradación Elegante: Asegúrese de que incluso si JavaScript no se carga o ejecuta, el contenido del acordeón permanezca accesible (aunque quizás no colapsable). El HTML semántico aún debería proporcionar alguna estructura.
• Frameworks y Bibliotecas: Si utiliza frameworks de JavaScript (React, Vue, Angular) o bibliotecas de UI, consulte su documentación de accesibilidad. Muchos proporcionan componentes de acordeón accesibles de fábrica o con atributos específicos.

Probando la Accesibilidad

Las pruebas exhaustivas son vitales para garantizar que sus widgets de acordeón sean realmente accesibles.

• Herramientas Automatizadas: Use extensiones de navegador (como Axe, WAVE) o verificadores en línea para identificar problemas comunes de accesibilidad.
• Pruebas con Teclado: Navegue y opere el acordeón usando solo el teclado (Tab, Shift+Tab, Enter, Spacebar, teclas de flecha). Asegúrese de que todos los elementos interactivos sean alcanzables y operables.
• Pruebas con Lector de Pantalla: Pruebe con lectores de pantalla populares (NVDA, JAWS, VoiceOver). Escuche cómo se anuncian la estructura del acordeón y los cambios de estado. ¿Tiene sentido? ¿Se transmite correctamente el estado `aria-expanded`?
• Pruebas con Usuarios: Si es posible, involucre a usuarios con discapacidades en su proceso de prueba. Sus comentarios son invaluables para identificar problemas de usabilidad en el mundo real.
• Pruebas en Navegadores y Dispositivos: Pruebe en diferentes navegadores y dispositivos, ya que el renderizado y el comportamiento de JavaScript pueden variar.

Perspectivas Globales y Localización

Al diseñar para una audiencia global, considere estos factores:

• Idioma: Asegúrese de que todo el texto, incluidas las etiquetas de los botones y el contenido, sea claro, conciso y fácilmente traducible. Evite modismos o referencias culturalmente específicas.
• Longitud del Contenido: La expansión del contenido puede afectar significativamente el diseño de la página. Tenga en cuenta que el contenido traducido puede ser más largo o más corto que el original. Pruebe cómo su acordeón maneja diferentes longitudes de contenido.
• Convenciones de UI Culturales: Si bien la funcionalidad principal de los acordeones es universal, los elementos de diseño sutiles pueden percibirse de manera diferente entre culturas. Apéguese a patrones establecidos y affordances claras.
• Rendimiento: Para los usuarios en regiones con conexiones a internet más lentas, asegúrese de que su JavaScript esté optimizado y que el contenido dentro de los acordeones no afecte excesivamente los tiempos de carga inicial de la página.

Ejemplos de Acordeones Accesibles

Muchas organizaciones de renombre demuestran patrones de acordeón accesibles:

• Sistema de Diseño de GOV.UK: A menudo citado por su compromiso con la accesibilidad, GOV.UK proporciona componentes bien documentados, incluidos los acordeones, que se adhieren a las WCAG.
• MDN Web Docs: Mozilla Developer Network ofrece guías detalladas y ejemplos sobre la creación de widgets accesibles, incluidos los acordeones, con explicaciones claras del uso de ARIA.
• Sistemas de Diseño de Grandes Empresas Tecnológicas: Empresas como Google (Material Design), Microsoft (Fluent UI) y Apple proporcionan componentes de sistemas de diseño que a menudo priorizan la accesibilidad. Consultarlos puede ofrecer patrones de implementación robustos.

Conclusión

Los widgets de acordeón son herramientas poderosas para organizar el contenido y mejorar la experiencia del usuario. Sin embargo, su naturaleza dinámica exige un enfoque consciente hacia la accesibilidad. Al adherirse a las pautas de WCAG, aprovechar el HTML semántico, implementar ARIA correctamente, garantizar una navegación robusta por teclado y realizar pruebas exhaustivas, puede crear componentes de acordeón que sean usables y agradables para todos, en todo el mundo. Priorizar la accesibilidad desde el principio no solo garantiza el cumplimiento, sino que también conduce a un producto más inclusivo y fácil de usar para todos.

Recuerde, el diseño accesible no es una ocurrencia tardía; es una parte integral del buen diseño. Al dominar la implementación de widgets de acordeón accesibles, contribuye a una web más equitativa y usable para todos los usuarios.