التدريب

دورة ذاتية لفريق يعتمد Lily: ثماني وحدات، لكل منها هدف وشيء للقراءة وتمرين تنجزه في متصفح حقيقي واختبار ذاتي مع الإجابات. نحو يوم كامل؛ ووحدة في كل جلسة تناسب كثيرًا.

قبل أن تبدأ

اختر درسًا لإطار عمل واحد وأنهِه أولًا. شغّل أحد تطبيقات الأمثلة محليًا، أو استخدم صفحات المكوّنات هنا، للتمارين. تحتاج إلى لوحة مفاتيح، وللوحدة 8 إلى قارئ شاشة: VoiceOver على macOS وiOS، أو NVDA على Windows، أو TalkBack على Android، وكلها مجانية.

الوحدة 1 — ما معنى عديم الواجهة

الهدف: أن تعرف ما يقرره Lily وما تقرره أنت.

اقرأ: صفحة «حول»، وصفحة مكوّن واحدة، مثل Button، من أولها إلى آخرها.

افعل: اعرض Button و TextInput دون ورقة أنماط. ثم اربط سمة، ثم سمة أخرى. لاحظ ما تغيّر وما لم يتغيّر.

اختبار ذاتي: ما الذي لا يحمله مكوّن Lily أبدًا؟ وما الذي يحمله دائمًا؟

أبدًا: CSS أو خطوط أو أيقونات أو صور (باستثناء أيقونات المنتقيات)، أو نص إنجليزي، أو جلب بيانات، أو لغة أو عملة افتراضية. دائمًا: أدق عنصر HTML، وصنفه بصيغة kebab-case أولًا، وARIA حيث يقصر HTML، وسلوك لوحة المفاتيح، وتمرير سماتك الأخرى.

اختبار ذاتي: تريد إطارًا أحمر على زر واحد. أين تضعه؟

في CSS الخاص بك، على الصنف (.button) أو على صنف تضيفه. لا في المكوّن أبدًا.

الوحدة 2 — لوحة المفاتيح والتركيز

الهدف: استخدام كل مكوّن واختباره دون فأرة.

اقرأ: جدول تفاعلات لوحة المفاتيح في TabBar، Listbox و Dialog.

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

اختبار ذاتي: لماذا يأخذ شريط التبويبات محطة Tab واحدة لا محطة لكل تبويب؟

النمط المركّب في APG: Tab ينتقل بين عناصر الواجهة، وتنتقل الأسهم داخل العنصر الواحد (فهرس تنقّل متجوّل). شريط تبويبات بعشر محطات يجبر مستخدم لوحة المفاتيح على ضغط Tab عشر مرات لتجاوزه.

اختبار ذاتي: بعد إغلاق مربع حوار مشروط، أين يجب أن يكون التركيز؟

على عنصر التحكم الذي فتحه. تستخدم مربعات الحوار المشروطة في Lily الدالة showModal()، التي تُبقي أيضًا Tab داخل مربع الحوار ما دام مفتوحًا.

الوحدة 3 — الأسماء والأدوار والحالات

الهدف: أن تعطي كل عنصر تحكم اسمًا يستطيع قارئ الشاشة نطقه، بكلماتك.

اقرأ: قسم ARIA في IconButton و SwitchButton.

افعل: في تطبيقك، مع تشغيل خادم التطوير، اعرض IconButton دون label. افتح وحدة تحكم المتصفح: يحذّر Lily من أن عنصر التحكم بلا اسم ميسّر. أضف التسمية وتحقّق من زوال التحذير. (التحذيرات موجودة في بنية التطوير فقط، لذا تبقى صفحة الإنتاج، مثل هذا الموقع، صامتة.)

اختبار ذاتي: متى تستخدم aria-label، ومتى النص المرئي؟

النص المرئي كلما أمكن: يراه الجميع، ويستطيع مستخدمو الإدخال الصوتي نطقه. aria-label فقط حيث لا يوجد نص مرئي، كالأيقونة. وإن وُجد الاثنان، فيجب أن يحتوي الاسم على الكلمات المرئية (WCAG 2.5.3).

اختبار ذاتي: حالة تُعرض بالأحمر فقط. ما الناقص؟

النص. يمكن للون أن يكرر معنى لكنه لا يحمله وحده أبدًا (WCAG 1.4.1)؛ الحالة تحتاج إلى كلمات.

الوحدة 4 — النماذج

الهدف: بناء نموذج يستطيع أي شخص أن يجد أخطاءه ويصلحها.

اقرأ وافعل: درس النماذج الميسّرة، بخطواته الخمس.

اختبار ذاتي: يفشل النموذج في التحقق. إلى أين يذهب التركيز، وماذا يُقرأ؟

إلى ملخص الأخطاء، الذي يُعلن بعنوانه وقائمة روابطه، رابط لكل خطأ، يقود كل منها إلى حقله.

اختبار ذاتي: لماذا لا تعطّل زر الإرسال حتى يصبح النموذج صالحًا؟

الزر المعطّل لا يستطيع أن يقول ما الخطأ، وكثيرون لا يفهمون لماذا لا يفعل شيئًا.

الوحدة 5 — السمات والتباين

الهدف: إعادة تنسيق Lily دون الإخلال بالتباين أو التركيز.

اقرأ: درس السمات وجدول تباين السمات .

افعل: استبدل --color-primary بلون علامتك التجارية. تحقّق من أن زوجه، --color-primary-content، يبلغ 4.5:1، وأن حلقة التركيز ما زالت تظهر على الصفحة.

اختبار ذاتي: لون علامتك التجارية باهت جدًا للنص الأبيض. هل يمكنك استخدامه؟

نعم، للزخرفة (--lily-brand: شريط الرأس، أو خط فاصل، أو خلفية الشعار)، لا للنص ولا لحدود عنصر التحكم أبدًا. يستخدم النص والحدود أزواج المحتوى في السمة.

الوحدة 6 — العالم كله

الهدف: ألا تجعل أي بلد هو الافتراضي.

اقرأ وافعل: نموذج يعمل في كل أنحاء العالم.

اختبار ذاتي: لماذا لا يملك CurrencyInput عملة افتراضية؟

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

اختبار ذاتي: صفحة بالعربية. ماذا تضبط، وماذا يجب أن يفعل CSS الخاص بك؟

lang="ar" و dir="rtl" (يضبط منتقي اللغة الاثنين)؛ ويستخدم CSS الخاص بك خصائص منطقية لينعكس التخطيط من تلقاء نفسه.

الوحدة 7 — الحركة

الهدف: التحريك دون إيذاء أحد.

اقرأ: وصفات الحركة.

افعل: فعّل «تقليل الحركة» في نظام التشغيل وأعد تحميل صفحة فيها وصفة الشريط المتحرك. يجب أن يقف ساكنًا وأن ينكسر إلى أسطر. ثم اصل إلى زر الإيقاف المؤقت بلوحة المفاتيح.

اختبار ذاتي: شيء يتحرك من تلقاء نفسه أكثر من خمس ثوانٍ. ماذا يجب أن يملك؟

طريقة لإيقافه مؤقتًا أو إيقافه أو إخفائه (WCAG 2.2.2)، يمكن الوصول إليها بلوحة المفاتيح، لا بالتمرير فقط.

الوحدة 8 — تحقّق من عملك

الهدف: اختبار صفحة كما يختبر Lily صفحاته.

افعل: خذ صفحة بنيتها في هذه الدورة وأجرِ أربعة اختبارات:

  1. axe (إضافة المتصفح، أو @axe-core/playwright في اختبار): لا مخالفات.
  2. لوحة المفاتيح وحدها: كل مهمة منجزة، والتركيز ظاهر دائمًا، ولا ينحبس أبدًا.
  3. كبّر إلى 400% وضيّق النافذة إلى 320 بكسلًا: لا تمرير جانبي، ولا شيء مقطوع.
  4. قارئ شاشة: لكل عنصر تحكم اسم ودور وحالة، والأخطاء تُعلن.
اختبار ذاتي: لا يُبلغ axe عن مخالفات. هل الصفحة ميسّرة؟

لم يثبت ذلك بعد. تجد الاختبارات الآلية ربما ثلث المشكلات؛ وتجد اختبارات لوحة المفاتيح والتكبير وقارئ الشاشة كثيرًا مما تبقى. راجع صفحة الجودة لمعرفة ما تحقّق منه Lily نفسه وما لم يتحقّق منه.

بعد الدورة