إمكانية الوصول

إمكانية الوصول، بصراحة.

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

اقرأ هذا أولاً.

هذا تقييمنا الذاتي الصادق. لم يخضع لتدقيق خارجي، ولا يوجد VPAT معتمد. تلتقط الأدوات الآلية نحو ثلث المشكلات فقط. نصمم تباين الألوان ليحقق الحدود المطلوبة، لكننا لا نقيسه في اختباراتنا. وقد يتغير التباين عند تغيير السمة. اجتياز الفحوص الآلية مجرد بداية.

ملخص

الدعم على مستوى المكون، بينما معايير الصفحة والمحتوى مسؤولية مشتركة معك (التفاصيل أدناه).

المجالالحالة
الاستخدام بلوحة المفاتيحمدعوم
ظهور التركيز وإدارتهمدعوم
قارئات الشاشة و ARIAمدعوم
العربية والاتجاهمدعوم
وضع التباين العاليمدعوم
تقليل الحركةمدعوم
تباين الألوانبالتصميم، غير مقيس
حجم الهدف وبنية الصفحةمشترك معك

طريقة البناء

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

  • أسس موثوقةتعتمد القوائم والحوارات والتبويبات والمنزلقات ومنتقيات التاريخ على Radix و React Aria في لوحة المفاتيح و ARIA.
  • تركيز ظاهر للوحة المفاتيحتظهر حلقات التركيز لمستخدمي لوحة المفاتيح وتختفي عند النقر بالفأرة، ونتحقق منها في الاختبارات.
  • وضع التباين العالييصمد التركيز والحدود والحالات في وضع التباين العالي في Windows عبر 63 من 66 ملف أنماط.
  • تقليل الحركةكل حركة تحترم إعداد تقليل الحركة.
  • العربية أصلاً، ومفروضةيستخدم التخطيط كله الخصائص المنطقية، ويفشل اختبار مخصص البناء إذا تسلل أي CSS يمين/يسار.
  • تحذيرات أثناء البناءتنبه العناصر أثناء التطوير عند غياب اسم وصول مطلوب.

كيف نختبرها

نقيّم التوافق بأنفسنا، باختبارات آلية ويدوية.

axe-core
فحوص آلية على كل المكونات (64 مكون)، بالإنجليزية والعربية.
Playwright
47 اختبار شامل للوحة المفاتيح والتركيز والأسهم و Escape والعربية.
بوابة RTL
اختبار يفشل البناء عند أي CSS يمين/يسار.
اختبارات الوحدة
أكثر من 1700 اختبار عبر المكونات.

حدود معلومة

  • لم تخضع المكتبة لتدقيق خارجي، ولا يوجد VPAT معتمد. هذا تقييم ذاتي.
  • لا نقيس تباين الألوان في اختباراتنا. تستهدف الألوان الافتراضية الحدود المطلوبة، لكن تغيير السمة أو الخلفيات المخصصة قد يقصر عنها. لذا تحقق منها بنفسك.
  • يتحقق الحد الأدنى لحجم الهدف في حقول النماذج، لكنه غير مدقق عبر كل مكون ومقاس.
  • الفحوص الآلية بداية. اختبر بقارئ شاشة حقيقي ومحتوى حقيقي.

ما يقع عليك

تمنحك المكتبة لبنات متاحة الوصول. ويبقى على تطبيقك:

  • إعطاء العناصر والأزرار الأيقونية والمناطق اسماً واضحاً.
  • إضافة نص بديل للصور والأيقونات والوسائط التي تمررها.
  • الحفاظ على ترتيب عناوين سليم، ومعالم، وعنوان صفحة، ولغة واتجاه للصفحة.
  • إعادة فحص التباين إذا غيّرت السمة.
  • كتابة نصوص خطأ ومساعدة واضحة. تربطها المكتبة بالحقول، والكتابة عليك.
  • الاختبار بقارئ شاشة (NVDA و VoiceOver و JAWS) وبلوحة المفاتيح، على محتواك الحقيقي.

أبلغ عن مشكلة

نتعامل مع أخطاء الوصول بأولوية عالية. أرفق المكون، وتقنيتك المساعدة، والمتصفح والنظام، وما توقعته وما حدث.

افتح مشكلة

البيان الكامل

هذه الصفحة ملخص، والبيان الكامل مع جدول WCAG 2.2 AA في المستودع.

اقرأ البيان الكامل

لبنات متاحة الوصول، موثقة بصدق.