Garis Panduan Kebolehcapaian Kandungan Web (WCAG) 2.1 menetapkan ambang kuantitatif bagi menjamin bahawa maklumat tekstual dan sempadan struktur antara muka pengguna kekal jelas untuk dibaca oleh individu yang mengalami penglihatan terhad sederhana atau masalah penglihatan warna. Pematuhan bergantung pada pengiraan nisbah kontras antara dua warna pepejal: persembahan latar depan (teks) dan substrat latar belakang.
Kriteria Ambang WCAG 2.1
- Teks Biasa AA (Kontras Minimum): Memerlukan nisbah minimum
4.5:1untuk teks biasa di bawah 18 poin (24px) atau teks tebal di bawah 14 poin (kira-kira 18.66px). - Teks Biasa AAA (Kontras Dipertingkatkan): Memerlukan nisbah minimum
7.0:1untuk tipografi teks biasa. - Teks Besar AA: Memerlukan sekurang-kurangnya
3.0:1untuk tipografi pada atau melebihi 18 poin (24px) berat biasa atau 14 poin (18.66px) berat tebal. - Teks Besar AAA: Memerlukan sekurang-kurangnya
4.5:1untuk tipografi saiz besar. - Objek Grafik dan Komponen Antara Muka Pengguna (AA): Memerlukan sekurang-kurangnya
3.0:1terhadap warna latar belakang bersebelahan untuk sempadan kawalan borang, garis luar butang interaktif, gelung fokus (focus ring), dan grafik carta yang bermakna.
Contoh Token Reka Bentuk Pengeluaran
Semasa mengisytiharkan token warna dalam sistem reka bentuk moden, petakan pasangan warna yang mematuhi kebolehcapaian kepada sifat tersuai CSS semantik bagi memastikan perubahan tema sentiasa mengekalkan pematuhan statutori:
:root {
/* Token Permukaan */
--color-surface-canvas: #ffffff;
--color-surface-subtle: #f8fafc;
--color-surface-inverted: #0f172a;
/* Token Teks - Mematuhi WCAG AAA pada Kanvas (Nisbah > 7.0:1) */
--color-text-primary: #0f172a; /* 16.0:1 pada #ffffff */
--color-text-secondary: #475569; /* 7.3:1 pada #ffffff */
/* Token Teks - Mematuhi WCAG AA pada Kanvas (Nisbah >= 4.5:1) */
--color-text-muted: #64748b; /* 4.6:1 pada #ffffff */
/* Token Komponen UI Interaktif (Nisbah >= 3.0:1) */
--color-border-input: #94a3b8; /* 3.1:1 pada #ffffff */
--color-focus-ring: #2563eb; /* 4.6:1 pada #ffffff */
}
.btn-accessible {
background-color: var(--color-surface-inverted);
color: #ffffff; /* nisbah 16.0:1 - lulus AAA */
border: 1px solid var(--color-surface-inverted);
outline-offset: 2px;
}
.btn-accessible:focus-visible {
outline: 2px solid var(--color-focus-ring);
}
Dengan menyandarkan tipografi dan warna sempadan pada token yang diaudit, asas kod bahagian hadapan dapat mengelakkan kemerosotan kontras yang tidak disengajakan apabila komponen disusun semula atau disarangkan merentasi konteks tema cerah dan gelap.