Skip to main content

Palette-Kontrast validéieren

D'Fäegkeet Palette-Kontrast validéieren iwwerpréift Faarfpuer an denger Design-Palette op WCAG (Web Content Accessibility Guidelines)-Konformitéit, ier se op däin theme ugewannt ginn.

Iwwersiicht

Dës Fäegkeet suergt dofir, datt d'Faarfschema vun denger Säit Accessibilitéitsstandarden erfëllt, andeems Kontrastverhältnisser tëscht Text- an Hannergrondfaarwen validéiert ginn. Si hëlleft Faarfkombinatiounen ze vermeiden, déi fir Benotzer mat visuellen Aschränkunge schwéier ze liese kéinte sinn.

Input-Format

D'Fäegkeet akzeptéiert eng Faarfpalette als Input:

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

Parameteren

ParameterTypeRequiredDescription
colorsarrayYesArray vu Faarfobjekter mat name- an hex-Eegenschaften
wcag_levelstringNoWCAG-Konformitéitsniveau: "A", "AA" (Standard), oder "AAA"
pairs_to_checkarrayNoSpezifesch Faarfpuer fir ze validéieren (z. B. ["primary-text", "background-text"])

Iwwerpréift WCAG-Niveauen

D'Fäegkeet validéiert Kontrastverhältnisser no WCAG-Standarden:

NiveauNormalen TextGroussen TextMindestverhältnis
A3:13:13:1
AA4.5:13:14.5:1
AAA7:14.5:17:1
  • Normalen Text — Text méi kleng wéi 18pt (oder 14pt fett)
  • Groussen Text — Text 18pt oder méi grouss (oder 14pt fett oder méi grouss)

Output-Schema

D'Fäegkeet gëtt en detailléierte Validéierungsrapport zeréck:

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

Output-Felder

FieldTypeDescription
compliantbooleanOb déi ganz Palette dem spezifizéierte WCAG-Niveau entsprécht
wcag_levelstringDe WCAG-Niveau, deen iwwerpréift gouf
pairsarrayDetailléiert Resultater fir all Faarfpuer
contrast_rationumberDat berechent Kontrastverhältnis (1:1 bis 21:1)
statusstring"pass" oder "fail" fir all Puer
recommendationsarrayVirschléi fir feelerschloend Puer ze verbesseren

Benotzungsbeispill

Prompt:

Kuck, ob meng Faarfpalette de WCAG AA-Standarden entsprécht. Ech hunn d'Primärfaarf #678233, d'Textfaarf #ffffff, an den Hannergrond #f5f5f5.

Resultat: D'Fäegkeet validéiert all Faarfkombinatiounen a gëtt zeréck:

  • ✅ Primär + Text: Verhältnis 5.2:1 (besteet WCAG AA)
  • ✅ Hannergrond + Text: Verhältnis 12.1:1 (besteet WCAG AAA)
  • Am Ganzen: Konform mat WCAG AA

Integratioun mam Theme Builder

Wann s du d'Design-Richtungs-Auswiel vum Theme Builder benotz, mécht d'Fäegkeet Palette-Kontrast validéieren Folgendes:

  1. Analyséiert deng ausgewielt Faarfpalette
  2. Iwwerpréift all Text-Hannergrond-Kombinatiounen
  3. Validéiert géint däin ausgewielte WCAG-Niveau
  4. Liwwert Recommandatioune fir net-konform Puer
  5. Verhënnert d'Uwendung vun net accessibelen Faarfschemen

Bescht Praktiken

  • Fänk mam AA-Niveau un — WCAG AA ass de Standard fir déi meescht Websäiten
  • Test virum Uwenden — validéier deng Palette, ier s du dech op en Design festleees
  • Iwwerpréif all Kombinatiounen — suerg dofir, datt Text, Linken an UI-Elementer all d'Standarden erfëllen
  • Berécksiichteg Benotzerpreferenzen — verschidde Benotzer kënnen zousätzlech Faarfsensibilitéit hunn
  • Benotz Kontrastchecker — kombinéier dës Fäegkeet mat Browser-Tools fir d'Verifikatioun

Feelerschloend Puer a Recommandatiounen

Wann e Faarfpuer d'Validéierung net besteet, liwwert d'Fäegkeet Recommandatiounen:

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