إمكانية الوصول
إمكانية الوصول، بصراحة.
لا يقدم النظام المرجعي الرسمي أي بيان لإمكانية الوصول. يوضح هذا البيان بالضبط ما ندعمه، وكيف نختبره، وما يبقى على عاتقك.
اقرأ هذا أولاً.
هذا تقييمنا الذاتي الصادق. لم يخضع لتدقيق خارجي، ولا يوجد 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 في المستودع.
لبنات متاحة الوصول، موثقة بصدق.