Skip to main content

Palitral Kontrastı Yoxlamaq

Palitral Kontrastı Yoxlamaq funksionallığı, dizayn palitranızdakı rəng cütlərini, onları mövzuya tətbiq etməzdən əvvəl WCAG (Web Kontentə Giriş Uyğunluğu Təlimatları) standartlarına uyğunluq baxımından yoxlayır.

Ümumi Baxış​

Bu funksiya, mətn və fon rəngləri arasındakı kontrast nisbətlərini yoxlamaqla saytınızın rəng sxeminin giriş uyğunluğu standartlarını təmin etdiyinə əmin olur. Bu, vizual çatışmazlığı olan istifadəçilər üçün oxuması çətin ola biləcək rəng kombinasiyalarını qarşısını almağa kömək edir.

Giriş Formatı​

Funksiya, giriş olaraq bir rəng palitrası qəbul edir:

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

Parametrlər​

ParametrTipTələb OlunurTəsvir
colorsarrayBəliname və hex xüsusiyyətlərinə malik rəng obyektlərinin massivi
wcag_levelstringXeyrWCAG uyğunluq səviyyəsi: "A", "AA" (default) və ya "AAA"
pairs_to_checkarrayXeyrYoxlanılacaq müəyyən rəng cütləri (məsələn, ["primary-text", "background-text"])

Yoxlanılan WCAG Səviyyələri​

Funksiya, WCAG standartlarına uyğun olaraq kontrast nisbətlərini yoxlayır:

SəviyyəNormal MətnBöyük MətnMinimum Nisbət
A3:13:13:1
AA4.5:13:14.5:1
AAA7:14.5:17:1
  • Normal Mətn — 18pt-dən kiçik mətn (və ya 14pt qalın)
  • Böyük Mətn — 18pt və ya daha böyük mətn (və ya 14pt qalın və ya daha böyük)

Çıxış Şeması​

Funksiya, ətraflı bir yoxlama hesabatı qaytarı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": []
}
}

Çıxış Sahələri​

SahəTipTəsvir
compliantbooleanBütün palitranın göstərilən WCAG səviyyəsinə uyğun olub-olmadığı
wcag_levelstringYoxlanılan WCAG səviyyəsi
pairsarrayHər bir rəng cütləri üçün ətraflı nəticələr
contrast_rationumberHesablanmış kontrast nisbəti (1:1-dən 21:1-ə)
statusstringHər bir cüt üçün "pass" (keçdi) və ya "fail" (keçmədi)
recommendationsarrayKeçməyən cütləri yaxşılaşdırmaq üçün təkliflər

İstifadə Nümunəsi​

Sual:

Rəng palitramın WCAG AA standartlarına uyğun olub-olmadığını yoxlayın. Primary rəngim #678233, mətn rəngim #ffffff və fon rəngim #f5f5f5-dir.

Nəticə: Funksiya bütün rəng kombinasiyalarını yoxlayır və aşağıdakıları qaytarır:

  • ✅ Primary + Mətn: 5.2:1 nisbəti (WCAG AA-dan keçir)
  • ✅ Fon + Mətn: 12.1:1 nisbəti (WCAG AAA-dan keçir)
  • Ümumi: WCAG AA-ya uyğundur

Mövzu Qurucu ilə İntegrasiya​

Mövzu Qurucusu (Theme Builder) dizayn istiqaməti seçərkən, Palitral Kontrastı Yoxlamaq funksionallığı:

  1. Seçdiyiniz rəng palitrasını təhlil edir
  2. Bütün mətn-fon kombinasiyalarını yoxlayır
  3. Seçdiyiniz WCAG səviyyəsinə görə yoxlayır
  4. Uyğun olmayan cütlər üçün təkliflər verir
  5. Giriş uyğun olmayan rəng sxemlərinin tətbiq edilməsini əngəlləyir

Ən Yaxşı Praktikalara Nəzarət​

  • AA səviyyəsi ilə başlayın — WCAG AA, əksər saytlar üçün standartdır.
  • Tətbiq etməzdən əvvəl yoxlayın — dizayna bağlı qalmadan əvvəl palitranızı yoxlayın.
  • Bütün kombinasiyaları yoxlayın — mətn, linklər və UI elementlərinin hamısının standartlara uyğun olduğundan əmin olun.
  • İstifadəçi üstünlüklərini nəzərə alın — bəzi istifadəçilərin əlavə rəng həssaslığı ola bilər.
  • Kontrast yoxlayıcılar istifadə edin — təsdiq üçün bu funksionallığı brauzer alətləri ilə birləşdirin.

Keçməyən Cütlər və Təkliflər​

Əgər bir rəng cütlüyü yoxlamadan keçmirsə, funksiya təkliflər verir:

{
"pair": "primary-text",
"status": "fail",
"contrast_ratio": 2.8,
"wcag_aa": false,
"recommendations": [
"Mətn rəngini #ffffff-ə açıqlayın (nisbət 5.2:1 olardı)",
"Fon rəngini #556b2f-ə tündləşdirin (nisbət 4.8:1 olardı)",
"Primary rəng kimi #4a6b1f kimi fərqli bir rəngdan istifadə edin (nisbət 6.1:1 olardı)"
]
}