Skip to main content

Paletės kontrasto patikrinimas

Validate Palette Contrast gebėjimas patikrina spalvų poras jūsų dizaino paletėje pagal WCAG (Web Content Accessibility Guidelines) atitiktį prieš pritaikant jas jūsų temai.

Apžvalga

Šis gebėjimas užtikrina, kad jūsų svetainės spalvų schema atitiktų prieinamumo standartus, patikrindamas kontrasto santykius tarp teksto ir fono spalvų. Jis padeda išvengti spalvų derinių, kuriuos gali būti sunku perskaityti naudotojams, turintiems regos sutrikimų.

Įvesties formatas

Gebėjimas kaip įvestį priima spalvų paletę:

{
"colors": [
{
"name": "primary",
"hex": "#678233"
},
{
"name": "text",
"hex": "#ffffff"
},
{
"name": "background",
"hex": "#f5f5f5"
}
],
"wcag_level": "AA"
}

Parametrai

ParameterTypeRequiredDescription
colorsarrayYesSpalvų objektų masyvas su name ir hex savybėmis
wcag_levelstringNoWCAG atitikties lygis: "A", "AA" (numatytasis) arba "AAA"
pairs_to_checkarrayNoKonkrečios spalvų poros, kurias reikia patikrinti (pvz., ["primary-text", "background-text"])

Tikrinami WCAG lygiai

Gebėjimas patikrina kontrasto santykius pagal WCAG standartus:

LevelNormal TextLarge TextMinimum Ratio
A3:13:13:1
AA4.5:13:14.5:1
AAA7:14.5:17:1
  • Įprastas tekstas — tekstas, mažesnis nei 18pt (arba 14pt paryškintas)
  • Didelis tekstas — 18pt arba didesnis tekstas (arba 14pt paryškintas ar didesnis)

Išvesties schema

Gebėjimas grąžina išsamią patikrinimo ataskaitą:

{
"compliant": true,
"wcag_level": "AA",
"pairs": [
{
"pair": "primary-text",
"color1": "#678233",
"color2": "#ffffff",
"contrast_ratio": 5.2,
"wcag_a": true,
"wcag_aa": true,
"wcag_aaa": false,
"status": "pass"
},
{
"pair": "background-text",
"color1": "#f5f5f5",
"color2": "#333333",
"contrast_ratio": 12.1,
"wcag_a": true,
"wcag_aa": true,
"wcag_aaa": true,
"status": "pass"
}
],
"summary": {
"total_pairs": 2,
"passing": 2,
"failing": 0,
"recommendations": []
}
}

Išvesties laukai

FieldTypeDescription
compliantbooleanAr visa paletė atitinka nurodytą WCAG lygį
wcag_levelstringWCAG lygis, kuris buvo patikrintas
pairsarrayIšsamūs kiekvienos spalvų poros rezultatai
contrast_rationumberApskaičiuotas kontrasto santykis (nuo 1:1 iki 21:1)
statusstring"pass" arba "fail" kiekvienai porai
recommendationsarrayPasiūlymai, kaip pagerinti neatitinkančias poras

Naudojimo pavyzdys

Užklausa:

Patikrinkite, ar mano spalvų paletė atitinka WCAG AA standartus. Turiu pagrindinę spalvą #678233, teksto spalvą #ffffff ir foną #f5f5f5.

Rezultatas: Gebėjimas patikrina visus spalvų derinius ir grąžina:

  • ✅ Pagrindinė + tekstas: santykis 5.2:1 (atitinka WCAG AA)
  • ✅ Fonas + tekstas: santykis 12.1:1 (atitinka WCAG AAA)
  • Bendrai: atitinka WCAG AA

Integracija su Theme Builder

Naudojant Theme Builder dizaino krypties pasirinkimą, Validate Palette Contrast gebėjimas:

  1. Išanalizuoja jūsų pasirinktą spalvų paletę
  2. Patikrina visus teksto ir fono derinius
  3. Patikrina pagal jūsų pasirinktą WCAG lygį
  4. Pateikia rekomendacijas neatitinkančioms poroms
  5. Neleidžia pritaikyti neprieinamų spalvų schemų

Geriausios praktikos

  • Pradėkite nuo AA lygio — WCAG AA yra standartas daugumai svetainių
  • Patikrinkite prieš pritaikydami — patikrinkite savo paletę prieš įsipareigodami dizainui
  • Patikrinkite visus derinius — įsitikinkite, kad tekstas, nuorodos ir UI elementai atitinka standartus
  • Atsižvelkite į naudotojų nuostatas — kai kurie naudotojai gali turėti papildomą jautrumą spalvoms
  • Naudokite kontrasto tikrintuvus — derinkite šį gebėjimą su naršyklės įrankiais patikrai

Neatitinkančios poros ir rekomendacijos

Jei spalvų pora nepraeina patikrinimo, gebėjimas pateikia rekomendacijas:

{
"pair": "primary-text",
"status": "fail",
"contrast_ratio": 2.8,
"wcag_aa": false,
"recommendations": [
"Lighten the text color to #ffffff (ratio would be 5.2:1)",
"Darken the background color to #556b2f (ratio would be 4.8:1)",
"Use a different primary color like #4a6b1f (ratio would be 6.1:1)"
]
}