Le Web Content Accessibility Guidelines (WCAG) 2.1 definiscono soglie quantitative per garantire che le informazioni testuali e i confini strutturali delle interfacce utente rimangano leggibili per persone con ipovisione moderata o deficit di percezione cromatica. La conformità si basa sul calcolo del rapporto di contrasto tra due colori pieni: la presentazione in primo piano e la superficie di sfondo.
Criteri di Soglia WCAG 2.1
- Testo Normale AA (Contrasto Minimo): Richiede un rapporto minimo di
4.5:1per il corpo del testo standard inferiore a 18 punti (24px) o testo in grassetto inferiore a 14 punti (circa 18.66px). - Testo Normale AAA (Contrasto Avanzato): Richiede un rapporto minimo di
7.0:1per la tipografia standard del corpo testo. - Testo Grande AA: Richiede almeno
3.0:1per caratteri pari o superiori a 18 punti (24px) con peso normale o 14 punti (18.66px) in grassetto. - Testo Grande AAA: Richiede almeno
4.5:1per testi di grandi dimensioni. - Oggetti Grafici e Componenti dell'Interfaccia Utente (AA): Richiede almeno
3.0:1rispetto ai colori di sfondo adiacenti per bordi dei campi modulo, contorni di pulsanti interattivi, indicatori di focus grafici e grafici informativi.
Esempio di Token di Design in Produzione
Quando si dichiarano i token di colore in un design system moderno, associare combinazioni cromatiche accessibili a proprietà personalizzate CSS semantiche garantisce che i cambi di tema mantengano la conformità normativa:
:root {
/* Token Superficie */
--color-surface-canvas: #ffffff;
--color-surface-subtle: #f8fafc;
--color-surface-inverted: #0f172a;
/* Token Testo - Conforme WCAG AAA su Canvas (Rapporto > 7.0:1) */
--color-text-primary: #0f172a; /* 16.0:1 su #ffffff */
--color-text-secondary: #475569; /* 7.3:1 su #ffffff */
/* Token Testo - Conforme WCAG AA su Canvas (Rapporto >= 4.5:1) */
--color-text-muted: #64748b; /* 4.6:1 su #ffffff */
/* Token Componenti UI Interattivi (Rapporto >= 3.0:1) */
--color-border-input: #94a3b8; /* 3.1:1 su #ffffff */
--color-focus-ring: #2563eb; /* 4.6:1 su #ffffff */
}
.btn-accessible {
background-color: var(--color-surface-inverted);
color: #ffffff; /* Rapporto 16.0:1 - supera AAA */
border: 1px solid var(--color-surface-inverted);
outline-offset: 2px;
}
.btn-accessible:focus-visible {
outline: 2px solid var(--color-focus-ring);
}
Vincolando la tipografia e i colori dei bordi a token verificati, il codice front-end evita regressioni accidentali del contrasto quando i componenti vengono riorganizzati o annidati tra contesti di tema chiaro e scuro.