Introduzione
L'accessibilità rende un sito più facile da usare per tutti, non solo per le persone con disabilità. In più riduce i rischi legali, allarga il pubblico e migliora SEO e prestazioni. Ecco cinque interventi tecnici mirati che puoi mettere in pratica in poco tempo. Per ciascuno trovi che cosa fare, perché è importante e come verificarlo.
Consiglio 1: testi alternativi (alt) significativi e testi dei link descrittivi
Cosa fare: dai alle immagini attributi alt brevi e significativi e usa per i link testi chiari e descrittivi.
Perché: screen reader e tecnologie assistive si basano su questi elementi per descrivere i contenuti e la navigazione.
Come (in pratica):
-
Immagini decorative →
altvuoto:alt=""erole="presentation". -
Immagini informative →
altdescrittivo, che spieghi la funzione dell'immagine (non i dettagli visivi). -
Immagini complesse (grafici, diagrammi) → aggiungi una didascalia o una descrizione più estesa nel testo vicino oppure tramite
aria-describedby. -
Il testo del link deve far capire dove porta (evita «clicca qui» o «leggi di più» da soli).
Esempi:
<!-- Decorative -->
<img src="/pattern.svg" alt="" role="presentation" />
<!-- Informative -->
<img src="/team-portrait.jpg" alt="Four developers in the Byte Buddy office, smiling" />
<!-- Complex image with description -->
<img src="/sales-chart.png" alt="Quarterly sales chart" aria-describedby="chartDesc" />
<p id="chartDesc">Sales rose 12% in Q2 driven by product X; see table below for values.</p>
<!-- Descriptive link -->
<a href="/pdf/report-2025.pdf">Download the 2025 Accessibility Report (PDF, 2.1 MB)</a>
Verifiche rapide:
-
Disattiva le immagini nel browser: la pagina si capisce ancora?
-
Usa uno screen reader (NVDA, VoiceOver) e ascolta come vengono descritti immagini e link.
Consiglio 2: contrasto sufficiente, e mai solo il colore
Cosa fare: testi ed elementi dell'interfaccia devono rispettare i rapporti di contrasto minimi; non affidare un'informazione al solo colore.
Perché: con un contrasto basso i contenuti diventano illeggibili per le persone ipovedenti e su molti dispositivi e schermi datati. Affidarsi al solo colore esclude le persone daltoniche.
Come (in pratica):
- Rispetta i valori minimi di contrasto delle WCAG:
- Testo normale: almeno 4,5:1
- Testo grande (≥18pt, o ≥14pt in grassetto): almeno 3:1
- Componenti dell'interfaccia e oggetti grafici: almeno 3:1 in molti casi
-
Quando il colore indica uno stato, aggiungi un altro segnale visivo (per esempio un'icona, una sottolineatura, un'etichetta di testo).
-
Evita testi piccoli su sfondi poco contrastati (pulsanti, badge).
Suggerimento CSS (dimensioni leggibili e valori di riserva):
body { font-size: 16px; line-height: 1.4; color: #111; background: #fff; }
/* Ensure focus-visible has strong contrast */
a:focus, button:focus {
outline: 3px solid #005a9c; /* visible, meets contrast */
outline-offset: 3px;
}
Verifiche rapide:
-
Usa uno strumento di verifica del contrasto sulle parti più ricorrenti del sito (intestazione, piè di pagina, pulsanti).
-
Visualizza la pagina in scala di grigi (con gli strumenti per sviluppatori del browser o un'estensione): se un'informazione sparisce, dipende dal colore.
Consiglio 3: navigazione da tastiera e focus visibile
Cosa fare: ogni elemento interattivo deve essere utilizzabile da tastiera (Tab, Invio, barra spaziatrice, tasti freccia) e l'elemento che riceve il focus deve avere un indicatore del focus ben visibile.
Perché: molte persone usano la tastiera o dispositivi di input alternativi (sensori a pulsante, screen reader). Senza supporto da tastiera, l'accesso è bloccato.
Come (in pratica):
- Tutti gli elementi interattivi devono poter ricevere il focus (<button>, <a href>, <input> vanno bene; i controlli personalizzati richiedono tabindex, gestori degli eventi da tastiera e ruoli ARIA).
- Rispetta la semantica nativa: non far comportare un <div> come un pulsante, a meno di implementarne per intero il funzionamento da tastiera e l'accessibilità.
- Prevedi uno stile del focus chiaro e sempre visibile (non eliminare l'outline senza sostituirlo).
Esempio di controllo personalizzato accessibile:
<!-- Bad: non-focusable div -->
<div class="toggle" onclick="toggle()">On</div>
<!-- Good: semantic button -->
<button class="toggle" aria-pressed="false">On</button>
Verifiche rapide:
-
Percorri il sito con il tasto Tab, solo da tastiera (niente mouse). Riesci a raggiungere tutti gli elementi interattivi? Riesci ad attivarli?
-
Usa
Shift + Tabe, dove serve, i tasti freccia (menu, elenchi, caroselli).
Consiglio 4: HTML semantico e ARIA usati nel modo giusto
Cosa fare: preferisci gli elementi HTML semantici (<nav>, <main>, <header>, <footer>, <button>, <form>, intestazioni h1..h6) e ricorri ad ARIA solo per colmare ciò che la semantica non copre.
Perché: l'HTML semantico è la base dell'accessibilità, perché dà struttura ai contenuti per le tecnologie assistive e i motori di ricerca. Un uso scorretto di ARIA può fare più danni che altro.
Come (in pratica):
-
Struttura corretta delle intestazioni: un solo <h1> per pagina, poi <h2>/<h3> in ordine. Le intestazioni devono rispecchiare la gerarchia del documento.
-
Le regioni di riferimento (landmark: <main>, <nav>, <aside>) aiutano chi usa uno screen reader a orientarsi.
-
Usa ruoli, stati e proprietà ARIA solo quando l'HTML nativo non è in grado di esprimere quel ruolo o quello stato (per esempio role="dialog" per una finestra modale personalizzata, aria-expanded per un pannello espandibile personalizzato).
-
Non usare role="presentation" su elementi con contenuti significativi.
Esempi:
<header>
<h1>Byte Buddy — Dev Tutorials</h1>
<nav aria-label="Main Navigation">...</nav>
</header>
<main id="content">
<article>
<h2>How to Use Semantic HTML</h2>
<p>...</p>
</article>
</main>
Verifiche rapide:
-
Ispeziona le intestazioni con gli strumenti per sviluppatori del browser: seguono un ordine logico?
-
Esamina l'albero di accessibilità (Lighthouse, axe, pannello Accessibilità del browser) per controllare landmark e ruoli.
Consiglio 5: moduli accessibili, con etichette, istruzioni e messaggi di errore chiari
Cosa fare: ogni campo di un modulo deve avere un'etichetta, le istruzioni devono essere associate al campo nel codice e gli errori devono essere chiari e annunciati.
Perché: i moduli sono tra i punti di interazione più frequenti: un modulo non accessibile impedisce di registrarsi, completare un acquisto o inviare una richiesta.
Come (in pratica):
-
Usa
<label for="id">collegato ai campi, oppure racchiudi il campo dentro un<label>. -
Usa
aria-describedbyper collegare testi di aiuto o messaggi di errore. -
In fase di convalida, sposta il focus sul primo errore e fai in modo che i messaggi di errore siano associati ai campi nel codice, così che gli screen reader li leggano.
-
Non usare il solo segnaposto (placeholder) come etichetta: non la sostituisce.
Esempio:
<label for="email">Email address</label>
<input id="email" name="email" type="email"
aria-describedby="emailHelp emailError" />
<p id="emailHelp">We'll use this to send receipts.</p>
<p id="emailError" role="alert" aria-live="assertive" hidden>
Enter a valid email address.
</p>
Verifiche rapide:
-
Invia il modulo con dati non validi: gli errori vengono annunciati? Il focus si sposta sull'errore?
-
Compila il modulo usando solo la tastiera: etichette e istruzioni si vedono e si capiscono?
Strumenti e risorse (in breve)
-
Verifiche automatiche: axe DevTools, Lighthouse.
-
Test con tastiera e screen reader: NVDA (Windows), VoiceOver (macOS/iOS), navigazione solo da tastiera.
-
Strumenti di verifica del contrasto e simulatori di daltonismo (da aggiungere ai tuoi abituali strumenti o estensioni per sviluppatori).
-
Guida rapida alle WCAG per i livelli A / AA / AAA (fai riferimento alle WCAG 2.1 o successive).
Per concludere
Parti da questi cinque interventi: sono quelli con il maggiore impatto tra quanto uno sviluppatore può fare direttamente. Affianca ai test automatici le verifiche manuali (tastiera e screen reader) per scoprire ciò che sfugge. L'accessibilità si migliora per gradi: applica queste modifiche, verificale e tieni sotto controllo le regressioni nella pipeline CI/CD con strumenti automatici.



