Skip to main content

Palet Kontrastını Doğrulama

Palet Kontrastını Doğrulama özelliği, renklerinizi temanıza uygulamadan önce, tasarım paletinizdeki renk çiftlerini WCAG (Web İçeriği Erişilebilirlik Yönergeleri) uyumluluğu açısından kontrol eder.

Genel Bakış

Bu özellik, sitenizin renk şemasının, metin ve arka plan renkleri arasındaki kontrast oranlarını doğrulayarak erişilebilirlik standartlarına uygun olmasını sağlar. Görme engelli kullanıcılar için okuması zor olabilecek renk kombinasyonlarını önlemeye yardımcı olur.

Giriş Formatı

Bu özellik, bir renk paleti girişi kabul eder:

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

Parametreler

ParametreTipZorunluAçıklama
colorsarrayEvetname ve hex özelliklerine sahip renk nesneleri dizisi
wcag_levelstringHayırWCAG uyumluluk seviyesi: "A", "AA" (varsayılan) veya "AAA"
pairs_to_checkarrayHayırDoğrulanacak belirli renk çiftleri (örneğin, ["primary-text", "background-text"])

Kontrol Edilen WCAG Seviyeleri

Bu özellik, WCAG standartlarına göre kontrast oranlarını doğrular:

SeviyeNormal MetinBüyük MetinMinimum Oran
A3:13:13:1
AA4.5:13:14.5:1
AAA7:14.5:17:1
  • Normal Metin — 18pt'den küçük metin (veya 14pt kalın)
  • Büyük Metin — 18pt veya daha büyük metin (veya 14pt kalın veya daha büyük)

Çıkış Şeması

Bu özellik, ayrıntılı bir doğrulama raporu döndürür:

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

Çıkış Alanları

AlanTipAçıklama
compliantbooleanTüm paletin belirtilen WCAG seviyesine uyup uymadığını belirtir
wcag_levelstringKontrol edilen WCAG seviyesi
pairsarrayHer renk çifti için ayrıntılı sonuçlar
contrast_rationumberHesaplanan kontrast oranı (1:1 ila 21:1)
statusstringHer çift için "pass" (geçti) veya "fail" (kaldı)
recommendationsarrayBaşarısız olan çiftleri iyileştirmek için öneriler

Kullanım Örneği

İstem:

Renk paletimin WCAG AA standartlarına uyup uymadığını kontrol edin. Birincil rengim #678233, metin rengim #ffffff ve arka planım #f5f5f5.

Sonuç: Özellik, tüm renk kombinasyonlarını doğrular ve şunları döndürür:

  • ✅ Birincil + Metin: 5.2:1 oranı (WCAG AA'yı geçiyor)
  • ✅ Arka Plan + Metin: 12.1:1 oranı (WCAG AAA'yı geçiyor)
  • Genel: WCAG AA ile uyumlu

Tema Oluşturucu ile Entegrasyon

Tema Oluşturucu'nun tasarım yönü seçilirken, Palet Kontrastını Doğrulama özelliği:

  1. Seçtiğiniz renk paletini analiz eder
  2. Tüm metin-arka plan kombinasyonlarını kontrol eder
  3. Seçtiğiniz WCAG seviyesine göre doğrulama yapar
  4. Uyumsuz çiftler için öneriler sunar
  5. Erişilemez renk şemalarının uygulanmasını engeller

En İyi Uygulamalar

  • AA seviyesiyle başlayın — WCAG AA, çoğu web sitesi için standarttır
  • Uygulamadan önce test edin — paletinizi bir tasarıma bağlı kalmadan önce doğrulayın
  • Tüm kombinasyonları kontrol edin — metin, bağlantılar ve kullanıcı arayüzü öğelerinin tümünün standartlara uyduğundan emin olun
  • Kullanıcı tercihlerini düşünün — bazı kullanıcıların ek renk hassasiyetleri olabilir
  • Kontrast kontrolörleri kullanın — doğrulama için bu özelliği tarayıcı araçlarıyla birleştirin

Başarısız Çiftler ve Öneriler

Bir renk çifti doğrulama testi başarısız olursa, özellik öneriler sunar:

{
"pair": "primary-text",
"status": "fail",
"contrast_ratio": 2.8,
"wcag_aa": false,
"recommendations": [
"Metin rengini #ffffff yaparak açın (oran 5.2:1 olur)",
"Arka plan rengini #556b2f yaparak koyulaştırın (oran 4.8:1 olur)",
"Bunun yerine #4a6b1f gibi farklı bir birincil renk kullanın (oran 6.1:1 olur)"
]
}

İlgili Özellikler