Esempio di Struttura 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">
        Titolo Sezione 1
      </button>
    </h3>
    <div id="content-1" class="accordion-content" role="region" aria-labelledby="button-1">
      <p>Il contenuto per la sezione 1 va qui.</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">
        Titolo Sezione 2
      </button>
    </h3>
    <div id="content-2" class="accordion-content" role="region" aria-labelledby="button-2">
      <p>Il contenuto per la sezione 2 va qui.</p>
    </div>
  </div>
</div>

2. Attributi ARIA per Contenuti Dinamici

I ruoli e gli stati ARIA sono cruciali per informare le tecnologie assistive sul comportamento dell'accordion.

• `role="button"`: Sull'elemento interattivo (pulsante) che attiva/disattiva il contenuto.
• `aria-expanded`: Impostato su `true` quando il pannello di contenuto è visibile e `false` quando è nascosto. Questo comunica direttamente lo stato ai lettori di schermo.
• `aria-controls`: Sul pulsante, fa riferimento all'`id` del pannello di contenuto che controlla. Questo stabilisce un collegamento programmatico.
• `aria-labelledby`: Sul pannello di contenuto, fa riferimento all'`id` del pulsante che lo controlla. Questo crea un collegamento bidirezionale.
• `role="region"`: Sul pannello di contenuto. Questo indica che il contenuto è una sezione percepibile della pagina.
• `aria-hidden`: Sebbene `aria-expanded` sia preferibile per controllare gli stati di visibilità, `aria-hidden="true"` può essere usato sui pannelli di contenuto non visualizzati per evitare che vengano annunciati dai lettori di schermo. Tuttavia, garantire che il contenuto sia nascosto correttamente tramite CSS (`display: none;`) o rimosso dall'albero di accessibilità è più robusto.

Nota su `aria-hidden` vs. `display: none`: L'uso di `display: none;` in CSS rimuove efficacemente l'elemento dall'albero di accessibilità. Se si mostra/nasconde dinamicamente il contenuto con JavaScript senza `display: none;`, `aria-hidden` diventa più importante. Tuttavia, `display: none;` è generalmente il metodo preferito per nascondere i pannelli di contenuto.

3. Utilizzabilità da Tastiera

Assicurarsi che gli utenti possano interagire con l'accordion usando i comandi standard da tastiera.

• Navigazione con Tab: Gli header dell'accordion devono essere focalizzabili e apparire nell'ordine di tabulazione naturale della pagina.
• Attivazione: Premendo `Invio` o `Barra spaziatrice` su un header dell'accordion focalizzato si dovrebbe attivare/disattivare la visibilità del suo pannello di contenuto.
• Tasti Freccia (Opzionale ma Raccomandato): Per un'esperienza migliorata, considerare l'implementazione della navigazione con i tasti freccia:
  • `Freccia Giù`: Sposta il focus sull'header dell'accordion successivo.
  • `Freccia Su`: Sposta il focus sull'header dell'accordion precedente.
  • `Home`: Sposta il focus sul primo header dell'accordion.
  • `Fine`: Sposta il focus sull'ultimo header dell'accordion.
  • `Freccia Destra` (o `Invio`/`Barra spaziatrice`): Espande/comprime l'elemento accordion corrente.
  • `Freccia Sinistra` (o `Invio`/`Barra spaziatrice`): Comprime l'elemento accordion corrente e riporta il focus sull'header.

4. Indicatori Visivi di Focus

Quando un header dell'accordion riceve il focus da tastiera, deve avere un indicatore visivo chiaro. I contorni di focus predefiniti del browser sono spesso sufficienti, ma assicurarsi che non vengano rimossi da CSS (ad es., `outline: none;`) senza fornire uno stile di focus alternativo e altamente visibile.

Esempio di CSS per il focus:

.accordion-button:focus {
  outline: 3px solid blue; /* O un colore che soddisfi i requisiti di contrasto */
  outline-offset: 2px;
}

5. Visibilità e Presentazione del Contenuto

• Stato Predefinito: Decidere se le sezioni dell'accordion debbano essere compresse o espanse per impostazione predefinita. Per le FAQ o informazioni dense, iniziare con lo stato compresso è spesso la scelta migliore. Per la navigazione o i riepiloghi delle funzionalità, potrebbe essere utile avere una sezione espansa di default.
• Indizi Visivi: Usare indizi visivi chiari per indicare se una sezione è espansa o compressa. Potrebbe essere un'icona (ad es., un segno '+' o '-', una freccia su/giù) che cambia aspetto. Assicurarsi che anche queste icone siano accessibili (ad es., tramite `aria-label` se non hanno testo).
• Rapporti di Contrasto: Assicurarsi che il contenuto testuale all'interno dell'accordion e i pulsanti di attivazione/disattivazione soddisfino i requisiti di rapporto di contrasto delle WCAG (4.5:1 per il testo normale, 3:1 per il testo grande). Questo è vitale per gli utenti ipovedenti.
• Nessuna Perdita di Contenuto: Quando una sezione si espande, assicurarsi che il suo contenuto non fuoriesca dal contenitore o nasconda altri contenuti critici.

6. Gestire il Focus durante l'Attivazione/Disattivazione

Questo è un aspetto più avanzato ma cruciale per un'esperienza fluida.

• Espansione: Quando un utente espande una sezione, considerare di spostare il focus sul primo elemento interattivo all'interno del contenuto appena rivelato. Questo è particolarmente importante se il contenuto espanso contiene campi di modulo o link.
• Compressione: Quando un utente comprime una sezione, il focus dovrebbe tornare all'header dell'accordion che è stato attivato/disattivato. Ciò impedisce agli utenti di dover navigare a ritroso attraverso le sezioni precedentemente compresse.

L'implementazione della gestione del focus richiede tipicamente JavaScript per catturare e impostare programmaticamente il focus.

Implementare Accordion Accessibili con JavaScript

Sebbene l'HTML semantico e ARIA siano i primi passi, spesso è necessario JavaScript per gestire l'attivazione/disattivazione dinamica e potenzialmente la gestione del focus. Ecco un approccio concettuale in JavaScript:

// JavaScript concettuale per la Funzionalità dell'Accordion

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';
      
      // Attiva/disattiva lo stato aria-expanded
      button.setAttribute('aria-expanded', !isExpanded);

      // Attiva/disattiva la visibilità del contenuto (usando CSS per l'accessibilità)
      content.style.display = isExpanded ? 'none' : 'block'; // O usare un'attivazione/disattivazione di classe

      // Opzionale: gestione del focus all'espansione
      // if (!isExpanded) {
      //   const firstFocusableElement = content.querySelector('a[href], button, input, [tabindex]');
      //   if (firstFocusableElement) {
      //     firstFocusableElement.focus();
      //   }
      // }
    }
  });

  // Opzionale: anche la navigazione da tastiera (tasti freccia, ecc.) verrebbe implementata qui.
  // Ad esempio, gestendo gli eventi 'keydown'.
});

// Configurazione iniziale: nascondi il contenuto per impostazione predefinita e imposta aria-expanded su false
document.querySelectorAll('.accordion-content').forEach(content => {
  const headerButton = document.getElementById(content.getAttribute('aria-labelledby'));
  if (headerButton) {
    content.style.display = 'none'; // Nascondi il contenuto inizialmente
    headerButton.setAttribute('aria-expanded', 'false');
  }
});

Considerazioni Importanti per JavaScript:

• CSS per Nascondere: È buona norma usare CSS (ad es., `display: none;` o una classe che imposta `height: 0; overflow: hidden;` per transizioni più fluide) per nascondere il contenuto. Ciò garantisce che il contenuto venga rimosso dall'albero di accessibilità quando non è visibile.
• Degradazione Graduale: Assicurarsi che, anche se JavaScript non riesce a caricarsi o a essere eseguito, il contenuto dell'accordion rimanga accessibile (anche se forse non comprimibile). L'HTML semantico dovrebbe comunque fornire una certa struttura.
• Framework e Librerie: Se si utilizzano framework JavaScript (React, Vue, Angular) o librerie UI, controllare la loro documentazione sull'accessibilità. Molti forniscono componenti accordion accessibili pronti all'uso o con attributi specifici.

Testare l'Accessibilità

Test approfonditi sono vitali per garantire che i tuoi widget accordion siano veramente accessibili.

• Strumenti Automatizzati: Utilizzare estensioni del browser (come Axe, WAVE) o controllori online per identificare problemi comuni di accessibilità.
• Test da Tastiera: Navigare e utilizzare l'accordion usando solo la tastiera (Tab, Maiusc+Tab, Invio, Barra spaziatrice, Tasti freccia). Assicurarsi che tutti gli elementi interattivi siano raggiungibili e utilizzabili.
• Test con Lettori di Schermo: Testare con lettori di schermo popolari (NVDA, JAWS, VoiceOver). Ascoltare come vengono annunciate la struttura dell'accordion e le modifiche di stato. Ha senso? Lo stato `aria-expanded` è comunicato correttamente?
• Test con Utenti: Se possibile, coinvolgere utenti con disabilità nel processo di test. Il loro feedback è inestimabile per identificare problemi di usabilità nel mondo reale.
• Test su Browser e Dispositivi: Testare su diversi browser e dispositivi, poiché il rendering e il comportamento di JavaScript possono variare.

Prospettive Globali e Localizzazione

Quando si progetta per un pubblico globale, considerare questi fattori:

• Lingua: Assicurarsi che tutto il testo, incluse le etichette dei pulsanti e il contenuto, sia chiaro, conciso e facilmente traducibile. Evitare modi di dire o riferimenti culturalmente specifici.
• Lunghezza del Contenuto: L'espansione del contenuto può influire in modo significativo sul layout della pagina. Tenere presente che il contenuto tradotto può essere più lungo o più corto dell'originale. Testare come l'accordion gestisce diverse lunghezze di contenuto.
• Convenzioni UI Culturali: Sebbene la funzionalità principale degli accordion sia universale, elementi di design sottili potrebbero essere percepiti diversamente tra le culture. Attenersi a modelli consolidati e a indicazioni chiare.
• Prestazioni: Per gli utenti in regioni con connessioni internet più lente, assicurarsi che JavaScript sia ottimizzato e che il contenuto all'interno degli accordion non influisca eccessivamente sui tempi di caricamento iniziali della pagina.

Esempi di Accordion Accessibili

Molte organizzazioni autorevoli dimostrano modelli di accordion accessibili:

• GOV.UK Design System: Spesso citato per il suo impegno nell'accessibilità, GOV.UK fornisce componenti ben documentati, inclusi gli accordion, che aderiscono alle WCAG.
• MDN Web Docs: Il Mozilla Developer Network offre guide dettagliate ed esempi sulla creazione di widget accessibili, inclusi gli accordion, con spiegazioni chiare sull'uso di ARIA.
• Design System di Grandi Aziende Tecnologiche: Aziende come Google (Material Design), Microsoft (Fluent UI) e Apple forniscono componenti di design system che spesso danno priorità all'accessibilità. Fare riferimento a questi può offrire modelli di implementazione robusti.

Conclusione

I widget accordion sono strumenti potenti per organizzare i contenuti e migliorare l'esperienza utente. Tuttavia, la loro natura dinamica richiede un approccio coscienzioso all'accessibilità. Aderendo alle linee guida WCAG, sfruttando l'HTML semantico, implementando correttamente ARIA, garantendo una solida navigazione da tastiera e conducendo test approfonditi, è possibile creare componenti accordion che siano utilizzabili e piacevoli per tutti, in tutto il mondo. Dare priorità all'accessibilità fin dall'inizio non solo garantisce la conformità, ma porta anche a un prodotto più inclusivo e facile da usare per tutti.

Ricorda, il design accessibile non è un'aggiunta secondaria; è una parte integrante di un buon design. Padroneggiando l'implementazione di widget accordion accessibili, contribuisci a un web più equo e utilizzabile per tutti gli utenti.