8

Accessibilità

Nucleo comuneAccessibility

Per una parte dei nostri prodotti è un obbligo di legge con sanzione, per il resto è una buona pratica che costa poco se fatta subito e molto se fatta dopo. Il sistema costruisce sempre allo stesso livello, e verifica formalmente dove serve.

Quando è un obbligo

Committente è una PAObbligoSiti e app mobili della PA sono soggetti alla Legge Stanca e alla Direttiva UE 2016/2102: requisiti tecnici AgID su base WCAG 2.1 AA, e dichiarazione di accessibilità da pubblicare entro il 23 settembre di ogni anno
Fornitura a PA su appaltoObbligoLa Legge Stanca elenca fra i soggetti tenuti i fornitori di servizi informatici su appalto. Se consegniamo a un ente, l'obbligo è nel contratto e ricade su di noi
Privato con fatturato medio > 500 M€ObbligoIl DL 76/2020 ha esteso la Legge Stanca ai privati che offrono servizi al pubblico via web o app mobile sopra quella soglia, con dichiarazione annuale
Prodotto o servizio al consumatoreObbligoEuropean Accessibility Act, in Italia D.Lgs. 82/2022, applicabile dal 28 giugno 2025: e-commerce, servizi bancari, trasporti, comunicazione elettronica, media. Sanzioni fino a 40.000 € o al 5% del fatturato
Gestionale B2B internoNon copertoERP, MES, WMS usati dai dipendenti del committente non sono servizi al consumatore: fuori dall'EAA. Resta il divieto di discriminazione della legge 67/2006 verso un lavoratore con disabilità
App sugli storeDipendeApple e Google non rifiutano un'app per mancata accessibilità. Ma un'app pubblica su uno store è “immessa sul mercato”: se il servizio è al consumatore, l'EAA si applica, store o no
NucleoIl perimetro lo decide il committente, non il prodotto. Lo stesso applicativo è fuori obbligo per un'azienda da 30 milioni e dentro per una da 600, o per un ente. Per questo l'accessibilità è una delle dichiarazioni di avvio (A): si stabilisce al kickoff se il progetto è “conforme dichiarato” o “conforme non dichiarato”, perché il primo costa una verifica formale e il secondo no.

Il livello a cui costruiamo

8.1Lo standard è WCAG 2.1 livello AA, che è quello richiesto da AgID e dall'EAA via EN 301 549. Si costruisce a quel livello sempre, anche quando non è dovuto.nucleo
8.2Costruire accessibile costa poco, rimediare costa molto. Un applicativo con duecento schermate non si rende conforme a posteriori in una fase di progetto.nucleo
8.3Quando è dovuta, la conformità si verifica e si dichiara, non si presume. La dichiarazione richiede una valutazione documentata, non una spunta.nucleo
8.4WCAG 2.2 è il bersaglio mobile. Non è ancora il riferimento normativo italiano, ma i suoi criteri nuovi — target 24×24, focus non coperto, niente trascinamento obbligatorio — sono già rispettati dalle nostre regole.struttura

Cosa il sistema già garantisce

Gran parte di WCAG AA è già coperta da regole scritte altrove: qui si dice quale criterio soddisfano e come si verifica.

RequisitoCriterioVerifica
Contrasto 4,5:1 sul testo, 3:1 su oggetti grafici e testo grande — regola 5.11.4.3 / 1.4.11Automatica
Il colore non è mai l'unico segno: stato con la parola, errore con icona e testo — 14.3, 12.161.4.1Manuale
Tutto raggiungibile da tastiera, nessuna trappola — 7.5, 7.132.1.1 / 2.1.2Manuale
Focus sempre visibile, focusRing: 'auto' — 7.122.4.7Automatica
Etichetta sopra il campo, sempre presente, mai solo placeholder — 12.13.3.2 / 1.3.1Automatica
L'errore dice cosa fare, non che c'è un errore — 12.14, 14.93.3.1 / 3.3.3Manuale
Nessuna azione non richiesta, nessun movimento imposto — 7.22.2.2 / 3.2.2Manuale
Target di tocco 48px, distanza 8px — sezione 15. Oltre il livello AA: 2.5.8 è di WCAG 2.2 e 2.5.5 è AAA, ma le piattaforme lo chiedono2.5.8 · 2.2Automatica
Pavimento 13px e densità con l'interlinea — 4.2, 4.31.4.4 / 1.4.12Automatica
Tooltip e aria-label su ogni icona senza parola — 9.114.1.2Automatica
Il maiuscolo si applica, non si scrive — 4.41.3.1Automatica
Movimento nel rispetto di prefers-reduced-motion2.3.3Automatica

Cosa manca, e va aggiunto

8.5Ogni pagina ha un titolo e una gerarchia di intestazioni corretta. Un solo h1, nessun livello saltato: è così che si naviga con uno screen reader.nucleo
8.6Regioni dichiarate: header, nav, main, più un salto al contenuto come primo elemento focalizzabile.nucleo
8.7Le tabelle hanno intestazioni vere — th con scope — e una didascalia. Una griglia di div non si legge.nucleo
8.8Ciò che cambia senza ricaricare si annuncia: notifiche, esito del salvataggio, conteggio dei risultati dopo un filtro, con aria-live="polite".nucleo
8.9L'ordine del focus segue l'ordine visivo. Nessun tabindex positivo.struttura
8.10La lingua è dichiarata — lang="it" — e cambia con i18next.struttura
8.11A 200% di zoom non si perde contenuto. È il criterio che punisce le larghezze fisse.struttura
8.12Niente informazione solo in hover. Sul tocco non esiste, e con la tastiera nemmeno.nucleo

Sulle app negli store

Con Capacitor la app è la stessa SPA dentro un contenitore nativo: l'accessibilità è quella del web, letta però dallo screen reader del sistema. Tre cose cambiano.

CosaiOSAndroid
Screen readerVoiceOverTalkBack
Target di piattaforma44 × 44 pt48 × 48 dp — il nostro minimo
Testo ingrandito dal sistemaDynamic Type: il layout deve reggere l'ingrandimento, non tagliareFont size & Display size: idem
Campi di testo16px minimo, o iOS ingrandisce la pagina al focus—
8.13Su dispositivi a tocco il target minimo è 48px — il più grande fra i 44pt di Apple e i 48dp di Android, dato che il codice in webview è uno solo. Con mouse e tastiera valgono le misure dei componenti (bottone 36, comando a icona 34): lì il vincolo è la distanza fra i target, non la loro area.struttura
8.14Il layout regge il testo ingrandito dal sistema fino al 200%: niente altezze fisse su ciò che contiene testo.nucleo
8.15Prima di ogni pubblicazione, una passata con VoiceOver e una con TalkBack sui tre percorsi principali. È l'unica verifica che trova gli errori veri.struttura

Come si verifica

LivelloStrumentoQuando
In sviluppoeslint-plugin-jsx-a11yGate di npm run lint, insieme alle regole del design system (18)
Nei testaxe-core / vitest-axeSulle schermate principali, nella suite unitaria del frontend
Sui percorsiPlaywright + axeSugli scenari end-to-end già previsti dallo stack
A manoTastiera, VoiceOver, TalkBack, zoom 200%Prima di ogni rilascio. Gli strumenti automatici colgono circa un terzo dei problemi
FormaleValutazione documentataSolo dove la dichiarazione è dovuta
Da decidereTre cose, tutte gestionali e non di disegno. 1. Se esistono oggi committenti pubblici o sopra i 500 milioni: in quel caso la dichiarazione annuale è già scaduta o in scadenza. 2. Chi firma la valutazione — è una competenza che oggi non abbiamo in casa. 3. Se i requisiti di accessibilità entrano nelle offerte come voce esplicita, visto che su appalto pubblico sono un obbligo contrattuale.
AvvertenzaQuesta sezione riassume un quadro normativo e non è un parere legale. Prima di impegnarsi con un committente su una conformità dichiarata, la valutazione del perimetro va fatta da chi ne ha titolo.