QualiBooth

wcag

Come rendere il tuo sito conforme a WCAG 2.2

Una guida pratica per sviluppatori sulla conformità a WCAG 2.2: dalla scansione automatica con axe-core agli audit manuali e al monitoraggio continuo.

12 min read QualiBooth
Uno sviluppatore esamina i requisiti di conformità a WCAG 2.2 sullo schermo di un laptop.

Rendere il tuo sito web conforme a WCAG 2.2 è un processo, non una correzione una tantum. La conformità è il risultato di un flusso di lavoro ripetibile: comprendere lo standard, misurare il punto di partenza, correggere le cose giuste nell’ordine giusto, validare con tecnologia assistiva reale e utenti reali, documentare il risultato e impedire che regredisca. Questa guida trasforma quel flusso di lavoro in una roadmap concreta, passo dopo passo, che il tuo team può iniziare a usare oggi — senza ricorrere agli «overlay» di accessibilità, che mascherano i problemi nel DOM invece di correggerli e sono stati ripetutamente citati nelle cause legali.

Passo 1: Capire cosa richiede davvero WCAG 2.2

Prima di sottoporre a audit qualsiasi cosa, chiarisci l’obiettivo. Le Linee guida per l’accessibilità dei contenuti web sono organizzate attorno a quattro principi, riassunti dall’acronimo POUR:

  • Perceivable (Percepibile) — gli utenti devono poter percepire il contenuto. Pensa alle alternative testuali per le immagini, ai sottotitoli e alle trascrizioni per i media e a un contrasto cromatico sufficiente.
  • Operable (Utilizzabile) — ogni funzione deve funzionare senza mouse. La piena operabilità da tastiera, gli indicatori di focus visibili e l’assenza di trappole da tastiera sono requisiti fondamentali.
  • Understandable (Comprensibile) — contenuto e comportamento devono essere prevedibili. Etichette chiare, navigazione coerente, messaggi di errore utili e un linguaggio leggibile rientrano qui.
  • Robust (Robusto) — il markup deve poter essere interpretato dalla tecnologia assistiva attuale e futura, il che in pratica significa HTML valido e un uso corretto di nomi, ruoli e valori ARIA.

Ogni principio si articola in criteri di successo verificabili, e a ciascun criterio è assegnato un livello di conformità: A (essenziale), AA (la base legale e pratica che la maggior parte delle organizzazioni persegue) e AAA (avanzato). Quando si dice «WCAG 2.2 AA», si intende la conformità a tutti i criteri di successo di livello A e livello AA. WCAG 2.2 aggiunge nove nuovi criteri rispetto alla 2.1 — tra cui Focus non oscurato, Movimenti di trascinamento, Dimensione del target (minima) e Autenticazione accessibile — la maggior parte dei quali migliora l’esperienza per gli utenti di tastiera, ipovedenti e con disabilità motorie.

Aiuta capire perché questo è l’obiettivo. La conformità AA è quella richiamata dalle leggi e dai regolamenti che molto probabilmente ti riguardano: informati sulla conformità WCAG come standard tecnico, poi osserva come si collega all’European Accessibility Act, all’ADA per gli enti privati e pubblici statunitensi e alla Section 508 per le agenzie federali statunitensi e i loro fornitori. Se la terminologia ti mette in difficoltà lungo il percorso, tieni il nostro glossario dell’accessibilità aperto in una scheda.

Altri due concetti danno forma a qualsiasi dichiarazione di conformità onesta. Il primo è l’ambito di conformità: la conformità WCAG si applica alle pagine complete, non ai componenti isolati, e ai processi completi (ad es. un intero flusso di checkout) — non puoi affermare che una pagina è conforme se un passaggio di un’attività a più fasi fallisce. Il secondo è la tecnologia supportata dall’accessibilità: puoi affidarti solo a modalità di utilizzo di una funzione effettivamente supportate dalla tecnologia assistiva che i tuoi utenti usano. In pratica questo significa testare con screen reader e browser attuali invece di presumere che il solo markup valido garantisca un risultato utilizzabile. Tieni entrambi a mente quando definisci l’ambito del tuo lavoro nei passaggi seguenti; determinano ciò che puoi sostenere in modo difendibile di aver realizzato.

Passo 2: Eseguire una scansione automatica di base

Non puoi correggere ciò che non puoi misurare, quindi stabilisci una baseline. I test automatici sono rapidi, ripetibili ed eccellenti nell’individuare i guasti meccanici e ad alto volume che affliggono la maggior parte dei siti: testi alternativi mancanti, contrasto cromatico basso, link e pulsanti vuoti, campi modulo non etichettati, lingua del documento mancante e ID duplicati.

Gli strumenti basati sul motore open source axe-core — incluso il software di scansione dell’accessibilità di QualiBooth — producono un elenco prioritizzato di problemi in pochi minuti. Se vuoi solo una rapida valutazione del tuo punto di partenza, inizia con una scansione di accessibilità gratuita di alcune pagine chiave.

Alcune regole per mantenere onesta la tua baseline:

  1. Scansiona template rappresentativi, non l’intero sito. Testa la home page, un template di contenuto/articolo, una pagina prodotto o categoria, un modulo (registrazione, checkout, contatto) e qualsiasi dashboard autenticata. Correggere un template di solito corregge centinaia di pagine.
  2. Testa gli stati reali, non solo il caricamento iniziale. Apri i menu, espandi le fisarmoniche, attiva i modali e invia i moduli con errori. Molte violazioni compaiono solo negli stati interattivi.
  3. Registra i numeri. Cattura il conteggio dei problemi per gravità e per criterio di successo. Questo è il tuo benchmark prima/dopo e la base del tuo backlog di remediation.

Sii onesto sul limite: gli strumenti automatici rilevano in modo affidabile solo il 30–40 % dei problemi WCAG. Una scansione automatica pulita è necessaria, ma non è mai sufficiente per una vera dichiarazione di conformità.

Passo 3: Integrare l’automazione con un audit manuale

Il restante 60–70 % dei criteri WCAG richiede il giudizio umano. Questo testo alternativo trasmette davvero il significato dell’immagine, o descrive solo dei pixel? L’ordine di lettura e di focus è logico? I messaggi di errore dicono all’utente come recuperare? Un menu a discesa personalizzato viene annunciato correttamente e puoi raggiungerlo e azionarlo solo con la tastiera? Nessun motore può rispondere a queste domande in modo affidabile.

Un audit manuale strutturato copre tipicamente:

  • Operatività solo da tastiera — passa con il tab attraverso ogni elemento interattivo; conferma un indicatore di focus visibile, un ordine logico, l’assenza di trappole e che tutto ciò che puoi fare con il mouse lo puoi fare senza di esso.
  • Struttura semantica — intestazioni in una gerarchia significativa, landmark, elenchi marcati come elenchi, tabelle con intestazioni adeguate.
  • Moduli — etichette programmatiche, campi raggruppati, chiara indicazione dei campi obbligatori e messaggi di errore collegati agli input che descrivono.
  • Contenuto dinamico — modali che intrappolano e ripristinano il focus correttamente, regioni live che annunciano gli aggiornamenti e ARIA usato solo dove l’HTML nativo non può svolgere il compito.
  • Qualità del contenuto — testo dei link significativo, contrasto sufficiente nei contesti reali e contenuto che non si affida solo al colore o alla forma.

La nostra guida agli audit manuali di accessibilità illustra l’intera metodologia, e i problemi comuni di accessibilità da evitare sono una checklist rapida dei guasti che gli auditor trovano più spesso. Se preferisci che se ne occupino per te, il team di consulenza sull’accessibilità di QualiBooth esegue audit manuali esperti rispetto ai criteri WCAG 2.2 AA.

Passo 4: Prioritizzare e correggere

Un lungo elenco di violazioni è scoraggiante finché non lo metti in sequenza. Esegui il triage combinando l’impatto sull’utente e la portata:

  1. Prima i bloccanti. Tutto ciò che rende un’attività impossibile per un gruppo di utenti — trappole da tastiera, un checkout inaccessibile, un modulo di login non etichettato — va in cima, indipendentemente da quante istanze esistano.
  2. Poi i problemi ad alta frequenza, su tutto il sito. Un problema di contrasto o di focus nel tuo header, footer o in un componente del design system si moltiplica su ogni pagina. Correggerlo una volta offre il ritorno maggiore.
  3. Poi i problemi specifici di pagina e di contenuto. Un singolo testo alternativo mancante, un singolo controllo etichettato male o un salto di intestazione isolato.

Quando correggi, correggi la fonte, non il sintomo. Preferisci gli elementi HTML nativi ai <div> rappezzati con ARIA; correggi il componente del design system invece di ogni pagina che lo usa; e affronta le cause profonde nei template e nei componenti condivisi affinché la correzione si propaghi su larga scala. Riscansiona dopo ogni lotto così da vedere i numeri calare ed evitare di introdurre regressioni. Questo è anche il momento giusto per integrare l’accessibilità nei tuoi design token — imposta colori con contrasto sicuro, una dimensione minima del target di 24×24 px e stili di focus visibili come valori predefiniti, in modo che il nuovo lavoro nasca conforme.

Alcuni pattern di remediation ricorrono abbastanza spesso da meritare una menzione esplicita:

  • Usa la piattaforma. Un <button>, <a href>, <input>, <select> e <dialog> nativi offrono gratuitamente comportamento da tastiera, gestione del focus e un nome accessibile corretto. Ricorri ad ARIA solo per colmare lacune reali — e ricorda la prima regola di ARIA: non usare ARIA se basta un elemento nativo.
  • Assegna i nomi in modo programmatico. Ogni controllo ha bisogno di un nome accessibile da un <label>, aria-label o aria-labelledby — non solo dal testo visivo vicino. I pulsanti con sola icona sono il colpevole più comune.
  • Gestisci il focus deliberatamente. Quando si apre un modale, sposta il focus al suo interno, intrappolalo finché è aperto e riportalo all’elemento che l’ha attivato alla chiusura. Quando il contenuto si aggiorna senza una navigazione, usa una regione live così che gli utenti di screen reader sentano cosa è cambiato.
  • Non codificare il significato solo nel colore o nella forma. Abbina il colore a testo, icone o pattern affinché l’informazione sopravviva per gli utenti daltonici e ipovedenti.

Tieni traccia della remediation nel tuo normale issue tracker, etichettata per criterio di successo, così che il lavoro di accessibilità sia visibile accanto a tutto il resto invece di vivere in un foglio di calcolo separato che diventa obsoleto.

Passo 5: Testare con la tecnologia assistiva e con persone con disabilità

La conformità riguarda in definitiva se le persone reali possono usare il tuo sito. Qui contano due livelli di validazione, e non sono intercambiabili.

Test con screen reader. Verifica le tue correzioni rispetto alla tecnologia assistiva che le persone usano davvero: NVDA o JAWS con Chrome/Firefox su Windows, e VoiceOver con Safari su macOS e iOS. Ascolta nomi accurati, ruoli corretti, cambiamenti di stato annunciati e un ordine di lettura sensato. Una valutazione con screen reader ti offre una verifica professionale sulle principali combinazioni se al tuo team manca l’esperienza.

Test di usabilità con utenti con disabilità. Soddisfare ogni criterio di successo è il pavimento, non il soffitto — un sito può essere tecnicamente conforme e comunque frustrante da usare. Il segnale più affidabile proviene dagli audit condotti da persone con disabilità, che testano con la propria tecnologia assistiva e le proprie abitudini e portano alla luce barriere che le checklist non colgono. Questa è la differenza tra rispettare la lettera dello standard e offrire una vera accessibilità digitale.

Passo 6: Documentare la conformità (dichiarazione e VPAT/ACR)

Una volta corretto e validato, cattura il risultato. La documentazione è ciò che trasforma un «ci abbiamo provato» in una dichiarazione difendibile e comunicabile.

  • Dichiarazione di accessibilità. Una pagina pubblica che indica il tuo obiettivo di conformità (ad es. WCAG 2.2 AA), descrive ciò che hai fatto, elenca eventuali limitazioni note e offre agli utenti un modo per segnalare problemi. Molti regolamenti, incluso l’EAA, ne richiedono una.
  • VPAT / Accessibility Conformance Report. Una Voluntary Product Accessibility Template, compilata, diventa un ACR — l’artefatto standard che i team di approvvigionamento e gli acquirenti enterprise richiedono come prova. La nostra guida su cos’è un VPAT/ACR spiega il documento, e il servizio report VPAT produce un report accurato e supportato da audit che puoi consegnare a clienti e team legali.

Redigi questi documenti sulla base delle prove dei tuoi risultati di audit effettivi, non delle aspirazioni. Un VPAT che sovrastima la conformità è una passività, non un asset.

Passo 7: Mantenere la conformità nel tempo

L’accessibilità regredisce nel momento in cui un sito cambia — un nuovo componente, un modulo ridisegnato, un widget di terze parti o una modifica al contenuto possono reintrodurre silenziosamente delle barriere. La conformità è uno stato che mantieni, non un traguardo che superi una volta sola.

Integra l’accessibilità nel tuo ciclo di vita del software:

  1. Shift left. Aggiungi controlli automatici alla tua pipeline con l’integrazione dell’accessibilità in CI/CD così che le violazioni vengano individuate nelle pull request, prima del rilascio — il luogo più economico possibile per correggerle.
  2. Monitora la produzione. Pianifica audit di accessibilità ricorrenti per individuare regressioni e la deriva dei contenuti che i controlli pre-rilascio non vedranno.
  3. Abilita il tuo team. Fornisci a designer, sviluppatori e autori di contenuti un toolkit di accessibilità e standard condivisi così che l’accessibilità sia il default di tutti, non un ripensamento di uno specialista.
  4. Governa su larga scala. Per organizzazioni grandi o multi-sito, una piattaforma come Agora centralizza il tracciamento, la reportistica e la remediation tra i team.

Errori che fanno deragliare gli sforzi di conformità

I team che si bloccano lo fanno di solito per ragioni prevedibili. Fai attenzione a queste:

  • Affidarsi solo all’automazione. Un report automatico tutto verde copre solo un terzo dei criteri. Trattarlo come prova di conformità è l’errore più comune — e più rischioso dal punto di vista legale.
  • Comprare un overlay. Gli overlay e i «widget di accessibilità» promettono conformità istantanea iniettando JavaScript che sovrascrive la pagina. Non correggono il codice sottostante, spesso interferiscono con la tecnologia assistiva degli utenti stessi e sono stati citati in un numero crescente di reclami. Sono una scorciatoia verso il rischio, non verso la conformità.
  • Correggere le pagine invece dei sistemi. Correggere singole pagine lasciando rotto il design system significa che ogni nuova pagina reintroduce gli stessi difetti. Correggi prima i componenti condivisi e i template.
  • Trattarla come un progetto una tantum. Senza controlli CI/CD e audit ricorrenti, un sito conforme si allontana dalla conformità nell’arco di pochi cicli di rilascio.
  • Saltare gli utenti reali. La conformità tecnica senza test di usabilità può comunque lasciare gli utenti con disabilità incapaci di completare attività fondamentali.

Evitare questi errori impedisce che il tuo investimento si disperda nel momento in cui il progetto «viene rilasciato».

Mettere tutto insieme

Un percorso realistico verso WCAG 2.2 AA appare così: apprendi i principi POUR e l’obiettivo AA, esegui una scansione automatica di base, sovrapponi un audit manuale, correggi per impatto e portata, valida con screen reader e utenti con disabilità, documenta la tua conformità in una dichiarazione e in un VPAT, e poi mantienila in salute con controlli CI/CD e audit ricorrenti. Ogni passo rafforza il precedente — e nulla di tutto ciò dipende da un overlay che maschera il codice reale.

Inizia in piccolo e costruisci slancio: scansiona una manciata di template questa settimana, correggi gli stili di contrasto e di focus del tuo design system e inserisci un controllo automatico nella tua pipeline. Da lì, la roadmap qui sopra ti accompagna per il resto del percorso. Quando sei pronto ad accelerare, esplora i nostri prezzi, richiedi una demo o parla con un esperto di un piano di remediation su misura per il tuo stack.

Pronto a raggiungere WCAG 2.2 AA — e a mantenerlo?