ForHosting KIT · تحرير الصور وتحليلها

درجة حرفية لنسبة التباين

حوّل تباين زوج من الألوان إلى حرف تضعه في مراجعتك: يبلغ #111827 على الأبيض 17.74 مقابل 1 فيحصل على A، لأن الدرجة A تبدأ من 12 مقابل 1. وتتدرج الدرجات من A إلى E ثم الرسوب. مجاناً في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

المقدمة: #111827
الخلفية: #ffffff

تحصل على

نسبة التباين: 17.74
التقدير: A
تسمية التقدير: Excellent
الحد الأدنى للنطاق: 12

تأخذ أداة الدرجة الحرفية لنسبة التباين لونين ست عشريين —المقدمة والخلفية— وتحسب نسبة التباين الرسمية وفق WCAG 2.x ثم تضعها على مقياس حرفي ثابت من A إلى E حتى fail. يحتاج المصممون والمطوّرون ومراجعو إمكانية الوصول غالبًا إلى حرف واحد لوضعه في مراجعة تصميم أو جدول رموز أو ملخص طلب دمج، وليس فقط النسبة الخام وقيم AA/AAA المنطقية. يتبع المحرك الإضاءة النسبية: تُحوَّل كل قناة sRGB إلى خطية، وتُوزَّن الإضاءة بالمعاملات 0.2126 و0.7152 و0.0722، وتكون النسبة (الأفتح + 0.05) على (الأغمق + 0.05). النطاقات حتمية: تبدأ A من اثني عشر إلى واحد، وB من سبعة (AAA للنص العادي)، وC من أربعة فاصلة خمسة (AA للنص العادي)، وD من ثلاثة (AA للنص الكبير)، وE من اثنين، وما دون ذلك fail. لا تعتمد النتائج على الشبكة أو العينات العشوائية أو ساعة التقويم.

معنى الدرجة الحرفية للتباين ومحتوى الاستجابة

تضغط الدرجة الحرفية للتباين نسبة WCAG المستمرة في تسمية ترتيبية قصيرة يمكن لأصحاب المصلحة مسحها دون حفظ جداول العتبات. تعني الدرجة A أن الزوج يبلغ على الأقل اثني عشر إلى واحد —أعلى بكثير من AAA للنص العادي وقريب من السقف العملي لأزواج sRGB المقروءة باستثناء الأسود الخالص على الأبيض الخالص—. تعني الدرجة B سبعة إلى واحد على الأقل، عتبة AAA للنص العادي.

تعني الدرجة C أربعة فاصلة خمسة إلى واحد على الأقل، عتبة AA المألوفة لنص المتن. تعني الدرجة D ثلاثة إلى واحد على الأقل، وهي ما تزال تجتاز AA للنص الكبير لكنها أضعف من أن تكفي لنص متن صغير وفق الإرشادات نفسها. تعني الدرجة E اثنين إلى واحد على الأقل: يبقى فرق في الإضاءة، لكن الزوج يفشل في كل معايير WCAG لتباين النص.

تعني الدرجة fail نسبة أقل من اثنين إلى واحد —بما في ذلك الألوان المتطابقة بنسبة واحد إلى واحد— فلا ينبغي استخدام الزوج لنص أو أيقونة ذات معنى على ذلك السطح. لا يوجد زحف للصفحة ولا مزج للشفافية ولا عيّنات للتدرّجات: تقدّمون لونين ست عشريين صريحين وتتلقون درجة قابلة للتكرار مناسبة للتذاكر ورموز التصميم والبوابات الآلية.

عقد الإدخال وتحليل الـ hex ومنطق النطاقات القابل للتكرار

يجب أن يكون كلا القيمتين hex: رمز # اختياري، إما ثلاثة أرقام تتوسّع إلى ستة (#abc يصبح #aabbcc) أو ستة أرقام كاملة دون تمييز حالة الأحرف. تُرفض لاحقات الشفافية ودوال rgb() وhsl() وألوان CSS المسماة والأعداد الصحيحة المجرّدة برسالة تسمي الحقل وتعرض ما استُلم. يُحدّ كل لون باثنين وثلاثين حرفًا لإبقاء التحقق رخيصًا ومنع لصق مقتطفات CSS طويلة بالخطأ.

بعد التحليل تُحوَّل القنوات خطيًا بمنحنى sRGB المقطعي لـ WCAG —القسمة على 12.92 دون عتبة 0.04045، وإلا رفع ((c + 0.055) على 1.055) إلى الأس 2.4— ثم تُجمع في الإضاءة النسبية. تُختار الدرجة من النسبة ذات الفاصلة العائمة غير المُقرَّبة حتى لا يدّعي عرض 6.99 النطاق B إذا كانت النسبة الحقيقية ما تزال دون سبعة.

موضع الدرجات الحرفية في أنظمة التصميم والمراجعات والتكامل المستمر

تحتاج فرق المنتج غالبًا إلى درجة من حرف واحد للوحات المتابعة وقوائم مراجعة التصميم عندما تكون مصفوفة AA/AAA الكاملة أعرض من أن تلائم عمود جدول أو شارة حالة. يربط المهندسون العقد نفسه بفحوصات طلبات الدمج التي تمنع تغيير رمز إذا انخفض نص المتن الأساسي دون الدرجة C، أو تحذّر عندما تهبط العناوين الكبيرة إلى D. يرفق متخصصو ضمان الجودة وإمكانية الوصول الدرجة مع النسبة العددية بتقارير الأخطاء ليُصلَح الزوج الدقيق بدل التخمين من لقطة شاشة.

تتحقق فرق المحتوى والتسويق من أن رموز الحملة الست عشرية ما تزال تحصل على C على الأقل على خلفيات الموقع الفاتحة أو الداكنة. اقرنوا الأداة بفاحص مصفوفة AA/AAA كامل عندما تحتاجون أعلام امتثال منطقية، وبأدوات تحويل الألوان عندما يلزم اشتقاق hex من RGB أو HSL قبل التقييم.

حالات الاستخدام

بطاقات درجات رموز التصميم

قيّموا كل زوج مقدمة/خلفية في لوحة العلامة بحرف واحد للسمات الفاتحة والداكنة قبل تثبيت الرموز.

الأسئلة الشائعة

كيف تُربط الدرجات الحرفية بنسبة التباين؟

A ≥ 12، B ≥ 7 (AAA عادي)، C ≥ 4.5 (AA عادي)، D ≥ 3 (AA كبير)، E ≥ 2، وfail دون 2. تستخدم النطاقات نسبة WCAG غير المُقرَّبة؛ وتُقرَّب النسبة المعروضة إلى منزلتين عشريتين.

ما صيغ الألوان المقبولة؟

hex فقط: #RGB أو #RRGGBB مع أو بدون # في البداية ودون تمييز حالة الأحرف.

ما الفرق بينها وبين فاحص تباين WCAG AA/AAA؟

يعيد فاحص AA/AAA قيمًا منطقية نجاح/فشل للنص العادي والكبير. تربط هذه الأداة نسبة WCAG نفسها بمقياس حرفي A–E/fail لبطاقات الدرجات والشارات.

هل تفحص هذه الأداة موقعي بحثًا عن مشكلات تباين؟

لا. تقيّم فقط لونين ست عشريين تقدّمونهما. لتدقيق الصفحات الحية استخدموا ماسح إمكانية وصول مخصص؛ يجيب هذا الطرف عن سؤال الدرجة الحرفية لونين.

ماذا تعني الدرجة E؟

تعني أن نسبة الزوج تبلغ اثنين إلى واحد على الأقل، فيبقى بعض الفرق في الإضاءة، لكنه يرسب في كل معايير تباين النص في WCAG. وما دون ذلك يُعد رسوباً.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/color/contrast-grade

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/color/contrast-grade \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"foreground":"#111827","background":"#ffffff"}'

const res = await fetch("https://api.kit.forhosting.com/color/contrast-grade", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "foreground": "#111827",
    "background": "#ffffff"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/contrast-grade",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "foreground": "#111827",
    "background": "#ffffff"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/contrast-grade", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"foreground":"#111827","background":"#ffffff"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"foreground":"#111827","background":"#ffffff"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/contrast-grade", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "foreground": "#111827",
  "background": "#ffffff"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.contrast_grade",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

استخدموا المسار المجاني في المتصفح لورش اللوحات ورموز التصميم، أو واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج التكامل المستمر وأنظمة التصميم إلى مصفوفة الدرجات نفسها في كل مرة.

معنى الدرجة الحرفية للتباين ومحتوى الاستجابة

تعيد الاستجابة كل لون بصيغة #rrggbb صغيرة موحّدة وسلسلة rgb(r, g, b)، وتبلغ عن contrast_ratio مقربًا إلى منزلتين عشريتين، وتعيد سلسلتي grade وgrade_label، وتعرض band_min كأرضية رقمية للنطاق الفائز، وتوسّم method بـ wcag_contrast_letter_grade ليميّز الموجّهون هذه الصفحة عن فاحص AA/AAA فقط. يرفع الـ hex غير الصالح والحقول الناقصة والقيم غير النصية والسلاسل الطويلة جدًا خطأ invalid_input ولا تُحصَّل رسومها.

عقد الإدخال وتحليل الـ hex ومنطق النطاقات القابل للتكرار

أرسلوا كائن JSON فيه foreground للون النص أو الأيقونة وbackground لسطح الخلفية. تربط الأسماء البديلة fg وcolor1 وtext وhex1 باللون الأول، وbg وcolor2 وhex2 بالثاني حتى تحافظ النماذج والجداول على أسماء أعمدتها. تشترك أداة المتصفح المجانية وواجهة API المدفوعة في الوحدة النقية نفسها، فتتطابق الدرجة التي ترونها في هذه الصفحة مع الدرجة التي يخزّنها خط الأنابيب للزوج نفسه.

موضع الدرجات الحرفية في أنظمة التصميم والمراجعات والتكامل المستمر

يلصق المصممون أزواج hex من Figma أو ملف JSON للرموز ويقرؤون من A إلى fail قبل تثبيت مقياس للسمات الفاتحة والداكنة. في هذه الصفحة يعمل كل شيء داخل متصفحكم؛ عبر API تكلّف كل استعلام ناجح $0.002، ولا تُحصَّل رسوم التحقق الفاشل، ولا يُخزَّن شيء بعد عودة الاستجابة. هذا الفصل —استكشاف تفاعلي مجاني وواجهة API مدفوعة مطابقة— يوافق بقية كتالوج KIT من الفئة A.

حالات التكامل

شارات التباين في طلبات الدمج

استدعوا API من التكامل المستمر لإفشال البناء عندما تنخفض أزواج hex لنص المتن الأساسي دون الدرجة C (نطاق AA للنص العادي).

ملخصات مراجعة إمكانية الوصول

أرفقوا grade وgrade_label وcontrast_ratio بالتذاكر ليشارك المراجعون والمهندسون درجة قصيرة مع النسبة العددية.

أسئلة تقنية

كم تكلفة أداة الدرجة الحرفية لنسبة التباين؟

هي مجانية في متصفحكم على هذه الصفحة. عبر API يكلّف الطلب الناجح $0.002؛ ولا تُحصَّل المدخلات غير الصالحة.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

معنى الدرجة الحرفية للتباين ومحتوى الاستجابة

عقد الإدخال وتحليل الـ hex ومنطق النطاقات القابل للتكرار

موضع الدرجات الحرفية في أنظمة التصميم والمراجعات والتكامل المستمر

حالات الاستخدام

بطاقات درجات رموز التصميم

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

معنى الدرجة الحرفية للتباين ومحتوى الاستجابة

عقد الإدخال وتحليل الـ hex ومنطق النطاقات القابل للتكرار

موضع الدرجات الحرفية في أنظمة التصميم والمراجعات والتكامل المستمر

حالات التكامل

شارات التباين في طلبات الدمج

ملخصات مراجعة إمكانية الوصول

أسئلة تقنية

شكرًا