Exemplo de Estrutura 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 da Seção 1
      </button>
    </h3>
    <div id="content-1" class="accordion-content" role="region" aria-labelledby="button-1">
      <p>O conteúdo da seção 1 vai aqui.</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 da Seção 2
      </button>
    </h3>
    <div id="content-2" class="accordion-content" role="region" aria-labelledby="button-2">
      <p>O conteúdo da seção 2 vai aqui.</p>
    </div>
  </div>
</div>

2. Atributos ARIA para Conteúdo Dinâmico

Os papéis e estados ARIA são cruciais para informar as tecnologias assistivas sobre o comportamento do acordeão.

• `role="button"`: No elemento interativo (botão) que alterna o conteúdo.
• `aria-expanded`: Defina como `true` quando o painel de conteúdo estiver visível e `false` quando estiver oculto. Isso comunica diretamente o estado aos leitores de tela.
• `aria-controls`: No botão, referenciando o `id` do painel de conteúdo que ele controla. Isso estabelece um link programático.
• `aria-labelledby`: No painel de conteúdo, referenciando o `id` do botão que o controla. Isso cria um link bidirecional.
• `role="region"`: No painel de conteúdo. Isso indica que o conteúdo é uma seção perceptível da página.
• `aria-hidden`: Embora `aria-expanded` seja preferível para controlar os estados de visibilidade, `aria-hidden="true"` pode ser usado em painéis de conteúdo que não estão sendo exibidos no momento para evitar que sejam anunciados por leitores de tela. No entanto, garantir que o conteúdo seja devidamente ocultado via CSS (`display: none;`) ou removido da árvore de acessibilidade é mais robusto.

Nota sobre `aria-hidden` vs. `display: none`: Usar `display: none;` no CSS remove efetivamente o elemento da árvore de acessibilidade. Se você está mostrando/ocultando dinamicamente o conteúdo usando JavaScript sem `display: none;`, `aria-hidden` se torna mais importante. No entanto, `display: none;` é geralmente o método preferido para ocultar painéis de conteúdo.

3. Operabilidade por Teclado

Garanta que os usuários possam interagir com o acordeão usando comandos de teclado padrão.

• Navegação com Tab: Os cabeçalhos do acordeão devem ser focáveis e aparecer na ordem de tabulação natural da página.
• Ativação: Pressionar `Enter` ou `Barra de espaço` em um cabeçalho de acordeão focado deve alternar a visibilidade de seu painel de conteúdo.
• Teclas de Seta (Opcional, mas Recomendado): Para uma experiência mais aprimorada, considere implementar a navegação com as teclas de seta:
  • `Seta para Baixo`: Move o foco para o próximo cabeçalho do acordeão.
  • `Seta para Cima`: Move o foco para o cabeçalho do acordeão anterior.
  • `Home`: Move o foco para o primeiro cabeçalho do acordeão.
  • `End`: Move o foco para o último cabeçalho do acordeão.
  • `Seta para a Direita` (ou `Enter`/`Espaço`): Expande/recolhe o item de acordeão atual.
  • `Seta para a Esquerda` (ou `Enter`/`Espaço`): Recolhe o item de acordeão atual e move o foco de volta para o cabeçalho.

4. Indicadores de Foco Visual

Quando um cabeçalho de acordeão recebe foco do teclado, ele deve ter um indicador visual claro. Os contornos de foco padrão do navegador geralmente são suficientes, mas certifique-se de que não sejam removidos pelo CSS (por exemplo, `outline: none;`) sem fornecer um estilo de foco alternativo e altamente visível.

Exemplo de CSS para foco:

.accordion-button:focus {
  outline: 3px solid blue; /* Ou uma cor que atenda aos requisitos de contraste */
  outline-offset: 2px;
}

5. Visibilidade e Apresentação do Conteúdo

• Estado Padrão: Decida se as seções do acordeão devem estar recolhidas ou expandidas por padrão. Para FAQs ou informações densas, começar com elas recolhidas geralmente é melhor. Para navegação ou resumos de funcionalidades, ter uma seção expandida por padrão pode ser útil.
• Sinais Visuais: Use sinais visuais claros para indicar se uma seção está expandida ou recolhida. Isso pode ser um ícone (por exemplo, um sinal de '+' ou '-', uma seta para cima/baixo) que muda de aparência. Garanta que esses ícones também sejam acessíveis (por exemplo, via `aria-label` se não tiverem texto).
• Taxas de Contraste: Garanta que o conteúdo de texto dentro do acordeão e os botões de alternância atendam aos requisitos de taxa de contraste da WCAG (4.5:1 para texto normal, 3:1 para texto grande). Isso é vital para usuários com baixa visão.
• Sem Perda de Conteúdo: Quando uma seção se expande, garanta que seu conteúdo não transborde seu contêiner ou oculte outro conteúdo crítico.

6. Gerenciando o Foco ao Alternar

Este é um aspecto mais avançado, mas crucial para uma experiência contínua.

• Expandir: Quando um usuário expande uma seção, considere mover o foco para o primeiro elemento interativo dentro do conteúdo recém-revelado. Isso é especialmente importante se o conteúdo expandido contiver campos de formulário ou links.
• Recolher: Quando um usuário recolhe uma seção, o foco deve retornar ao cabeçalho do acordeão que foi alternado. Isso impede que os usuários tenham que navegar de volta por seções previamente recolhidas.

A implementação do gerenciamento de foco geralmente envolve JavaScript para capturar e definir o foco programaticamente.

Implementando Acordeões Acessíveis com JavaScript

Embora HTML semântico e ARIA sejam os primeiros passos, o JavaScript é frequentemente necessário para lidar com a alternância dinâmica e, potencialmente, com o gerenciamento de foco. Aqui está uma abordagem conceitual em JavaScript:

// JavaScript Conceitual para a Funcionalidade do Acordeão

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';
      
      // Alterna o estado de aria-expanded
      button.setAttribute('aria-expanded', !isExpanded);

      // Alterna a visibilidade do conteúdo (usando CSS para acessibilidade)
      content.style.display = isExpanded ? 'none' : 'block'; // Ou use uma alternância de classe

      // Opcional: Gerenciamento de foco ao expandir
      // if (!isExpanded) {
      //   const firstFocusableElement = content.querySelector('a[href], button, input, [tabindex]');
      //   if (firstFocusableElement) {
      //     firstFocusableElement.focus();
      //   }
      // }
    }
  });

  // Opcional: A navegação por teclado (teclas de seta, etc.) também seria implementada aqui.
  // Por exemplo, lidando com eventos 'keydown'.
});

// Configuração inicial: Ocultar conteúdo por padrão e definir aria-expanded como false
document.querySelectorAll('.accordion-content').forEach(content => {
  const headerButton = document.getElementById(content.getAttribute('aria-labelledby'));
  if (headerButton) {
    content.style.display = 'none'; // Ocultar conteúdo inicialmente
    headerButton.setAttribute('aria-expanded', 'false');
  }
});

Considerações Importantes para JavaScript:

• CSS para Ocultar: A melhor prática é usar CSS (por exemplo, `display: none;` ou uma classe que define `height: 0; overflow: hidden;` para transições mais suaves) para ocultar o conteúdo. Isso garante que o conteúdo seja removido da árvore de acessibilidade quando não estiver visível.
• Degradação Graciosa: Garanta que, mesmo que o JavaScript falhe ao carregar ou executar, o conteúdo do acordeão permaneça acessível (embora talvez não retrátil). O HTML semântico ainda deve fornecer alguma estrutura.
• Frameworks e Bibliotecas: Se estiver usando frameworks JavaScript (React, Vue, Angular) ou bibliotecas de UI, verifique a documentação de acessibilidade deles. Muitos fornecem componentes de acordeão acessíveis prontos para uso ou com atributos específicos.

Testando a Acessibilidade

Testes completos são vitais para garantir que seus widgets de acordeão sejam verdadeiramente acessíveis.

• Ferramentas Automatizadas: Use extensões de navegador (como Axe, WAVE) ou verificadores online para identificar problemas comuns de acessibilidade.
• Teste de Teclado: Navegue e opere o acordeão usando apenas o teclado (Tab, Shift+Tab, Enter, Barra de espaço, Teclas de seta). Garanta que todos os elementos interativos sejam alcançáveis e operáveis.
• Teste com Leitor de Tela: Teste com leitores de tela populares (NVDA, JAWS, VoiceOver). Ouça como a estrutura e as mudanças de estado do acordeão são anunciadas. Faz sentido? O estado `aria-expanded` é transmitido corretamente?
• Teste com Usuários: Se possível, envolva usuários com deficiência em seu processo de teste. O feedback deles é inestimável para identificar problemas de usabilidade no mundo real.
• Teste de Navegador e Dispositivo: Teste em diferentes navegadores e dispositivos, pois a renderização e o comportamento do JavaScript podem variar.

Perspectivas Globais e Localização

Ao projetar para um público global, considere estes fatores:

• Idioma: Garanta que todo o texto, incluindo rótulos de botões e conteúdo, seja claro, conciso e facilmente traduzível. Evite expressões idiomáticas ou referências culturalmente específicas.
• Comprimento do Conteúdo: A expansão do conteúdo pode afetar significativamente o layout da página. Esteja ciente de que o conteúdo traduzido pode ser mais longo ou mais curto que o original. Teste como seu acordeão lida com comprimentos de conteúdo variados.
• Convenções de UI Culturais: Embora a funcionalidade principal dos acordeões seja universal, elementos de design sutis podem ser percebidos de maneira diferente entre as culturas. Siga padrões estabelecidos e affordances claras.
• Desempenho: Para usuários em regiões com conexões de internet mais lentas, garanta que seu JavaScript seja otimizado e que o conteúdo dentro dos acordeões não impacte excessivamente os tempos de carregamento iniciais da página.

Exemplos de Acordeões Acessíveis

Muitas organizações respeitáveis demonstram padrões de acordeão acessíveis:

• Sistema de Design GOV.UK: Frequentemente citado por seu compromisso com a acessibilidade, o GOV.UK fornece componentes bem documentados, incluindo acordeões, que aderem à WCAG.
• MDN Web Docs: A Mozilla Developer Network oferece guias detalhados e exemplos sobre a criação de widgets acessíveis, incluindo acordeões, com explicações claras do uso de ARIA.
• Sistemas de Design de Grandes Empresas de Tecnologia: Empresas como Google (Material Design), Microsoft (Fluent UI) e Apple fornecem componentes de sistema de design que geralmente priorizam a acessibilidade. Referenciar estes pode oferecer padrões de implementação robustos.

Conclusão

Widgets de acordeão são ferramentas poderosas para organizar conteúdo e aprimorar a experiência do usuário. No entanto, sua natureza dinâmica exige uma abordagem consciente da acessibilidade. Ao aderir às diretrizes da WCAG, aproveitar o HTML semântico, implementar o ARIA corretamente, garantir uma navegação robusta por teclado e realizar testes completos, você pode criar componentes de acordeão que são utilizáveis e agradáveis para todos, em todo o mundo. Priorizar a acessibilidade desde o início não apenas garante a conformidade, mas também leva a um produto mais inclusivo e amigável para todos.

Lembre-se, o design acessível não é uma reflexão tardia; é parte integrante de um bom design. Ao dominar a implementação de widgets de acordeão acessíveis, você contribui para uma web mais equitativa e utilizável para todos os usuários.