Skip to main content

Valideer Paletkontras

Die Validate Palette Contrast vermoë kontroleer kleurpaare in jou ontwerppalet op nakoming van WCAG (Web Content Accessibility Guidelines) voordat dit op jou tema toegepas word.

Oorsig

Hierdie vermoë verseker dat jou webwerf se kleurskema toeganklikheidsstandaarde nakom deur kontrasverhoudings tussen teks- en agtergrondkleure te valideer. Dit help om kleurkombinasies te voorkom wat vir gebruikers met visuele beperkings moeilik kan wees om te lees.

Invoerformaat

Die vermoë aanvaar 'n kleurpalet as invoer:

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

Parameters

ParameterTipeVereisBeskrywing
colorsarrayJa'n Array van kleurobjekte met name en hex eienskappe
wcag_levelstringNeeWCAG-nakoomingsvlak: "A", "AA" (standaard), of "AAA"
pairs_to_checkarrayNeeSpesifieke kleurpaare om te valideer (bv. ["primary-text", "background-text"])

WCAG-Vlakke Gevalideer

Die vermoë valideer kontrasverhoudings volgens WCAG-standaarde:

VlakNormale TeksGroot TeksMinimum Verhouding
A3:13:13:1
AA4.5:13:14.5:1
AAA7:14.5:17:1
  • Normale Teks — teks kleiner as 18pt (of 14pt vet)
  • Groot Teks — teks van 18pt of groter (of 14pt vet of groter)

Uitvoer Skema

Die vermoë keer 'n gedetailleerde validasieverslag terug:

{
"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": []
}
}

Uitveld

VeldTipeBeskrywing
compliantbooleanOf die hele palet die gespesifiseerde WCAG-vlak nakom
wcag_levelstringDie WCAG-vlak wat gecontroleer is
pairsarrayGedetailleerde resultate vir elke kleurpaar
contrast_rationumberDie berekende kontrasverhouding (1:1 tot 21:1)
statusstring"pass" of "fail" vir elke paar
recommendationsarrayVoorstelle vir die verbetering van mislukte pare

Gebruiksvoorbeeld

Vraag:

Kontroleer of my kleurpalet aan WCAG AA-standaarde voldoen. Ek het primêrek kleur #678233, tekskleur #ffffff, en agtergrond #f5f5f5.

Resultaat: Die vermoë valideer al die kleurkombinasies en keer terug:

  • ✅ Primêr + Teks: 5.2:1 verhouding (kom WCAG AA)
  • ✅ Agtergrond + Teks: 12.1:1 verhouding (kom WCAG AAA)
  • Oor die algemeen: Nakoomend met WCAG AA

Integrasie met Tema Bouer

Wanneer jy die ontwykingsrigting-keuse van Theme Builder gebruik, sal die Validate Palette Contrast vermoë:

  1. Jou gekose kleurpalet ontleed
  2. Alle teks-agtergrondkombinasies kontroleer
  3. Valideer teen jou gekose WCAG-vlak
  4. Voorstelle verskaf vir nie-nakoomende pare
  5. Voorkom die toepassing van ontoeganklike kleurskemas

Beste Praktyke

  • Begin met AA-vlak — WCAG AA is die standaard vir die meeste webwerwe
  • Toets voordat jy toepas — valideer jou palet voordat jy jou ontwerp bevestig
  • Kontroleer al die kombinasies — verseker dat teks, skakels en UI-elemente almal aan die standaarde voldoen
  • Oorweeg gebruikersvoorkeure — sommige gebruikers mag bykomende kleurgevoeligheid hê
  • Gebruik kontraskontroleerders — kombineer hierdie vermoë met browsergereedskap vir verifikasie

Mislukte Pare en Voorstelle

As 'n kleurpaar die validasie misluk, verskaf die vermoë voorstelle:

{
"pair": "primary-text",
"status": "fail",
"contrast_ratio": 2.8,
"wcag_aa": false,
"recommendations": [
"Ligte die tekskleur na #ffffff (verhouding sou 5.2:1 wees)",
"Donker die agtergrondkleur na #556b2f (verhouding sou 4.8:1 wees)",
"Gebruik 'n ander primêre kleur soos #4a6b1f (verhouding sou 6.1:1 wees)"
]
}

Verwante Vermoë