ForHosting KIT · أدوات المطورين

ترتيب الألوان حسب السطوع

حوّلوا مجموعة غير مرتبة من ألوان Hex إلى تدرج ثابت من الداكن إلى الفاتح. تتحقق الأداة من كل قيمة، وتوحّد صيغتي Hex المختصرة والكاملة، وتحول قنوات sRGB إلى ضوء خطي، ثم ترتبها حسب السطوع النسبي WCAG.

● Betaمجاني · داخل متصفحك

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

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

تتضمن كل نتيجة اللون الموحّد وقيمة سطوعه، لتتمكنوا من فحص الفروق الدقيقة من دون الاعتماد على الانطباع البصري. تحتفظ الألوان المتساوية بترتيبها الأصلي، وتبقى القيم المكررة، وتنتج المدخلات نفسها المخرجات نفسها دائماً.

أنشئوا تدرج سطوع من لوحة ألوان غير مرتبة

غالباً ما تتبع مجموعات الألوان ترتيب إنشاء الرموز أو تسلسل حفظ الملف بدلاً من السطوع. أرسلوا مصفوفة colors لتحصلوا على سجلات مرتبة من أدنى سطوع نسبي إلى أعلاه. تُوسّع الصيغة ذات 3 خانات، وتقبل صيغة 6 خانات علامة # اختيارية، ويظهر الناتج دائماً بصيغة #rrggbb صغيرة. يسهّل هذا التوحيد حفظ اللقطات وملفات الرموز وتوليد CSS والمقارنة بين التشغيلات. لا تُحذف القيم المكررة لأنها قد تمثل رموزاً مختلفة. وتحافظ الألوان ذات السطوع المحسوب المتساوي تماماً على ترتيب الإدخال، فلا تتبدل بين التشغيلات. تذكر الاستجابة أيضاً العدد والاتجاه والطريقة. استخدموا القائمة لبناء لوحة متسلسلة أو لمراجعة الدرجات المتجاورة. لا تنشئ العملية ألواناً وسيطة، ولا تعيد تسمية الرموز، ولا تضمن تساوي الخطوات إدراكياً؛ إنها تغيّر الترتيب فقط.

افهموا كيف يحدد السطوع النسبي ترتيب الألوان

السطوع النسبي ليس متوسطاً بسيطاً لقيم الأحمر والأخضر والأزرق. ترمّز ألوان Hex قنوات sRGB بمنحنى غير خطي، لذلك تُقاس كل قناة بين صفر وواحد ثم تتحول إلى ضوء خطي. تُقسم القيم الواقعة عند عتبة sRGB أو دونها على 12.92، وتستخدم القيم الأعلى دالة القوة القياسية. بعد ذلك تُجمع القنوات بالمعاملات 0.2126 و0.7152 و0.0722. مساهمة الأخضر هي الأكبر والأزرق هي الأصغر، وتتراوح النتيجة من صفر للأسود إلى واحد للأبيض. يستخدم الفرز القيمة الكاملة غير المقربة، أما المنازل العشرية الست المعروضة فهي للقراءة والتسلسل الثابت فقط. يُستخدم هذا النموذج أيضاً في حسابات WCAG، لكن ترتيب اللوحة لا يثبت إمكانية الوصول. افحصوا كل زوج محدد من لون المقدمة والخلفية على حدة وفق حدود التباين المطلوبة.

تحققوا من المدخلات وادمجوا نتائج حتمية

يجب أن يكون الحقل colors مصفوفة غير فارغة لا تتجاوز 1000 عنصر. يجب أن يكون كل عنصر سلسلة من 3 أو 6 خانات سداسية عشرية بالضبط بعد علامة # اختيارية. تُهمل المسافات الخارجية، بينما تُرفض صيغ ألفا وأسماء CSS ودوال rgb() والأطوال الخاطئة والأنواع غير النصية. تحدد رسالة الخطأ فهرس العنصر المعيب من دون إسقاط قيمة أو تخمينها، فلا يقبل بناء نظام التصميم تدرجاً جزئياً يبدو صحيحاً. تنفذ الأداة حساباً محلياً وفرزاً في الذاكرة فقط، ولا تستخدم الشبكة أو الساعة أو العشوائية أو التخزين. لذلك تنتج المصفوفة نفسها JSON نفسه في المتصفح وبيئة CI وعبر API. التشغيل في المتصفح مجاني، وتكلفة طلب API هي $0.002. يتيح الاحتفاظ بالتكرارات وثبات التعادل ربط النتائج ببياناتها الوصفية الأصلية بصورة موثوقة.

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

ترتيب رموز التصميم

حوّلوا الألوان الموروثة أو المولدة إلى تسلسل ثابت قبل إسناد أرقام التدرج.

إعداد ألوان متسلسلة للمخططات

رتبوا العينات حسب السطوع النسبي ليجري التدرج البصري في اتجاه متسق.

مراجعة تطور لوحة الألوان

افحصوا قيم السطوع والألوان الموحدة لاكتشاف الانعكاسات أو التكرارات أو الفروق الضئيلة.

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

ما تكلفة طلب API؟

تكلفة كل طلب API هي $0.002. ويمكنكم أيضاً تشغيل المعالج الحتمي نفسه مجاناً في المتصفح.

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

استخدموا 3 أو 6 خانات Hex مع علامة # اختيارية، مثل #abc أو abc أو #aabbcc أو AABBCC.

هل تُقبل ألوان ألفا أو أسماء CSS؟

لا. تُرفض صيغة Hex ذات ألفا والأسماء ودوال rgb() وhsl() وغيرها من صيغ CSS لمنع الالتباس.

ماذا يحدث عند تساوي سطوع لونين؟

يحتفظان بترتيبهما النسبي الأصلي، وتحافظ هذه القاعدة الثابتة أيضاً على القيم المكررة بصورة حتمية.

هل يضمن ترتيب الداكن إلى الفاتح تبايناً متاحاً؟

لا. يصف الترتيب الألوان المفردة، أما إمكانية الوصول فتتطلب تقييم أزواج محددة من المقدمة والخلفية.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/color/sort-by-luminance

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

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

curl -X POST https://api.kit.forhosting.com/color/sort-by-luminance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"colors":["#f8fafc","#0f172a","#22c55e","#64748b"]}'

const res = await fetch("https://api.kit.forhosting.com/color/sort-by-luminance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "colors": [
      "#f8fafc",
      "#0f172a",
      "#22c55e",
      "#64748b"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/sort-by-luminance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "colors": [
        "#f8fafc",
        "#0f172a",
        "#22c55e",
        "#64748b"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/sort-by-luminance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"colors":["#f8fafc","#0f172a","#22c55e","#64748b"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"colors":["#f8fafc","#0f172a","#22c55e","#64748b"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/sort-by-luminance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "colors": [
    "#f8fafc",
    "#0f172a",
    "#22c55e",
    "#64748b"
  ]
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 1000

الأخطاء

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

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