Wytyczne dotyczące dostępności treści internetowych (WCAG) 2.1 określają ilościowe progi gwarantujące, że informacje tekstowe i granice elementów interfejsu użytkownika pozostają czytelne dla osób z umiarkowanym niedowidzeniem lub zaburzeniami rozpoznawania barw. Zgodność zależy od obliczenia współczynnika kontrastu między dwoma jednolitymi kolorami: barwą pierwszoplanową a podłożem tła.
Kryteria progowe WCAG 2.1
- Zwykły tekst AA (minimalny kontrast): Wymaga minimalnego współczynnika
4.5:1dla standardowego tekstu podstawowego poniżej 18 punktów (24 px) lub pogrubionego tekstu poniżej 14 punktów (około 18,66 px). - Zwykły tekst AAA (zwiększony kontrast): Wymaga minimalnego współczynnika
7.0:1dla standardowej typografii treści podstawowej. - Duży tekst AA: Wymaga co najmniej
3.0:1dla tekstu o rozmiarze co najmniej 18 punktów (24 px) przy zwykłej grubości lub 14 punktów (18,66 px) przy pogrubieniu. - Duży tekst AAA: Wymaga co najmniej
4.5:1dla dużej typografii. - Elementy graficzne i komponenty interfejsu użytkownika (AA): Wymaga co najmniej
3.0:1względem sąsiadujących kolorów tła dla obramowań kontrolek formularzy, obrysów interaktywnych przycisków, wskaźników fokusu oraz istotnych wykresów.
Przykład produkcyjnego tokenu projektowego
Deklarując tokeny kolorystyczne w nowoczesnym systemie projektowym, przypisz dostępne pary kolorów do semantycznych właściwości niestandardowych CSS, aby zmiany motywu zachowywały zgodność z wymogami formalnymi:
:root {
/* Tokeny powierzchni */
--color-surface-canvas: #ffffff;
--color-surface-subtle: #f8fafc;
--color-surface-inverted: #0f172a;
/* Tokeny tekstu — zgodne z WCAG AAA na Canvas (współczynnik > 7.0:1) */
--color-text-primary: #0f172a; /* 16.0:1 na #ffffff */
--color-text-secondary: #475569; /* 7.3:1 na #ffffff */
/* Tokeny tekstu — zgodne z WCAG AA na Canvas (współczynnik >= 4.5:1) */
--color-text-muted: #64748b; /* 4.6:1 na #ffffff */
/* Tokeny interaktywnych komponentów interfejsu (współczynnik >= 3.0:1) */
--color-border-input: #94a3b8; /* 3.1:1 na #ffffff */
--color-focus-ring: #2563eb; /* 4.6:1 na #ffffff */
}
.btn-accessible {
background-color: var(--color-surface-inverted);
color: #ffffff; /* współczynnik 16.0:1 — spełnia AAA */
border: 1px solid var(--color-surface-inverted);
outline-offset: 2px;
}
.btn-accessible:focus-visible {
outline: 2px solid var(--color-focus-ring);
}
Opierając typografię i kolory obramowań na zweryfikowanych tokenach, baza kodu front-endu unika przypadkowego pogorszenia kontrastu podczas przestawiania lub zagnieżdżania komponentów w jasnych i ciemnych motywach.