Ga naar hoofdinhoud

Controleer Paletcontrast

De functionaliteit Controleer Paletcontrast controleert kleurparen in uw ontwerppalet op naleving van WCAG (Web Content Accessibility Guidelines) voordat ze worden toegepast op uw thema.

Overzicht​

Deze functionaliteit zorgt ervoor dat het kleurenschema van uw site voldoet aan de toegankelijkheidsnormen door de contrastverhoudingen tussen tekst- en achtergrondkleuren te valideren. Het helpt te voorkomen dat kleurcombinaties moeilijk leesbaar zijn voor gebruikers met visuele beperkingen.

Input Formaat​

De functionaliteit accepteert een kleurenpalet als input:

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

Parameters​

ParameterTypeVereistBeschrijving
colorsarrayJaArray van kleurobjecten met name en hex eigenschappen
wcag_levelstringNeeWCAG-nalevnheidsniveau: "A", "AA" (standaard), of "AAA"
pairs_to_checkarrayNeeSpecifieke kleurparen om te valideren (bijv. ["primary-text", "background-text"])

Gecontroleerde WCAG Niveaus​

De functionaliteit valideert contrastverhoudingen volgens de WCAG-normen:

NiveauNormale TekstGrote TekstMinimaal Verhouding
A3:13:13:1
AA4.5:13:14.5:1
AAA7:14.5:17:1
  • Normale Tekst — tekst kleiner dan 18pt (of 14pt vet)
  • Grote Tekst — tekst van 18pt of groter (of 14pt vet of groter)

Output Schema​

De functionaliteit retourneert een gedetailleerd validatierapport:

{
"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 Velden​

VeldTypeBeschrijving
compliantbooleanOf het gehele palet voldoet aan het gespecificeerde WCAG-niveau
wcag_levelstringHet WCAG-niveau dat is gecontroleerd
pairsarrayGedetailleerde resultaten voor elk kleurpaar
contrast_rationumberDe berekende contrastverhouding (1:1 tot 21:1)
statusstring"pass" of "fail" voor elk paar
recommendationsarraySuggesties voor het verbeteren van falende paren

Gebruiksvoorbeeld​

Prompt:

Check if my color palette meets WCAG AA standards. I have primary color #678233, text color #ffffff, and background #f5f5f5.

Resultaat: De functionaliteit valideert alle kleurcombinaties en retourneert:

  • ✅ Primary + Text: 5.2:1 verhouding (voldoet aan WCAG AA)
  • ✅ Background + Text: 12.1:1 verhouding (voldoet aan WCAG AAA)
  • Algemeen: Voldoet aan WCAG AA

Integratie met Theme Builder​

Wanneer u de selectie van ontwerktijdsbestemming in Theme Builder gebruikt, dan:

  1. Analyseert de functionaliteit uw geselecteerde kleurenpalet
  2. Controleert alle tekst-achtergrondcombinaties
  3. Valideert tegen uw gekozen WCAG-niveau
  4. Biedt aanbevelingen voor niet-conforme paren
  5. Voorkomt het toepassen van onbereikbare kleurenschema's

Best Practices​

  • Begin met niveau AA — WCAG AA is de standaard voor de meeste websites
  • Test voordat u toepast — valideer uw palet voordat u een ontwerp vastlegt
  • Controleer alle combinaties — zorg ervoor dat tekst, links en UI-elementen allemaal voldoen aan de normen
  • Overweeg gebruikersvoorkeuren — sommige gebruikers kunnen extra kleurgevoel hebben
  • Gebruik contrastcheckers — combineer deze functionaliteit met browserhulpmiddelen voor verificatie

Falende Paren en Aanbevelingen​

Als een kleurpaar de validatie faalt, geeft de functionaliteit aanbevelingen:

{
"pair": "primary-text",
"status": "fail",
"contrast_ratio": 2.8,
"wcag_aa": false,
"recommendations": [
"Licht de tekstkleur op naar #ffffff (verhouding zou 5.2:1 zijn)",
"Verdonker de achtergrondkleur naar #556b2f (verhouding zou 4.8:1 zijn)",
"Gebruik een andere primaire kleur zoals #4a6b1f (verhouding zou 6.1:1 zijn)"
]
}