التثبيت والإعداد
إصدارات جاهزة الإعداد
- التثبيت على Drupal
- التثبيت على WordPress
- التثبيت على Kirby (مساهمة من المجتمع)
- التثبيت على CraftCMS (مساهمة من المجتمع)
التثبيت المخصص
لبناء تكاملك الخاص، نزّل نسخة محلية (أو أشِر إلى نسخة على CDN) من حزمة لغة، وملف JS المصغَّر، وملف CSS المصغَّر، ثم أنشئ مثيلًا جديدًا من «Ed11y».
عند استيراد وحدات ESM/JS:
استخدم ملفات JavaScript ذات الامتداد .umd مع المتصفحات والأنظمة القديمة:
المعاملات
لا يُستدعى التكامل المكتمل إلا للمحررين المسجَّل دخولهم (فأنت لا تريد أن يرى زوار موقعك المدقق!)، ويمكنه تجاوز أيٍّ من المعاملات الافتراضية.
لاحظ أن لجميع المعاملات قيمًا افتراضية؛ لذا لا تُضمِّن إلا ما تريد تجاوزه.
قد يبدو التكامل المخصَّص بدرجة كبيرة على هذا النحو:
كثيرًا ما تضبط التكاملات الجاهزة هذه المتغيرات أثناء التشغيل، فمثلًا تُحمِّل الصفحات في الوضع «assertive» إذا عُدِّلت مؤخرًا، ثم تعود إلى الوضع «polite» بعد عدة دقائق.
تخصيص المظهر
تتيح عدة معاملات اختيار قالب، وتجاوز الألوان، وحقن CSS.
لا تُضمِّن إلا المعاملات التي تحتاج إلى تجاوزها، لتسهيل التحديثات المستقبلية.
أحداث JS مفيدة
يمكن لمطوري القوالب الاستماع إلى هذه الأحداث للتفاعل معها وتعديل الصفحة حسب الحاجة.
بترتيب ظهورها المعتاد…
ed11yRunCustomTests: يُطلَق عندما يصبح كائن Results جاهزًا لحقن نتائج مخصصة فيه. لاحظ أنه يجب ضبط المعامل customTests على عدد دوال الاختبارات المخصصة التي ستشغّلها (…على الأرجح دالة واحدة…) كي يُطلَق هذا الحدث. التفاصيل في القسم التالي.ed11yResults: يُطلَق عند انتهاء جميع الفحوصات. يمكن لتكاملات API حينئذٍ استخراج البيانات من الكائن Ed11y.results.ed11yPanelOpened: يُطلَق عند فتح اللوحة، تلقائيًا أو يدويًا.ed11yShowHidden: يوفّر رقمdata-ed11y-resultوقيمة منطقيةviaJump. لا يُطلَق إلا إذا ضُبط المعامل «ed11yShowHidden» وكان أحد العناصر الأصل للعنصر يطابق محددًا. يُستخدم لإظهار التنبيهات الموجودة داخل حاويات لم تُفتح بعد، مثل الأكورديونات وعلامات التبويب ودوّارات الشرائح. أمثلة الاستخدام في القسم التالي.ed11yPop: يوفّر قيمة ID منdata-ed11y-result، إضافةً إلى مراجع للكائنينresultوtip. يُطلَق عند ظهور تلميح، مما يتيح لك تعديل التلميحات أثناء التشغيل.ed11yShut: يوفّر قيمة ID منdata-ed11y-result. يُطلَق عند إغلاق تلميح.ed11yDismissalUpdate: يوفّر معلومات موسّعة عندما يتجاهل مستخدم تنبيهًا أو يستعيده. يُستخدم لتكاملات API. يحتوي كائن الحدث على:dismissPagedismissTestdismissKeydismissAction
ستجد أمثلة في الأقسام التالية.
تعديل التلميحات
إذا كان كل ما تريده هو تعديل نص تلميح، فيمكنك تجاوز العناصر مباشرةً في الكائن العام ed11yLang.en (قبل استدعاء المكتبة) أو في الكائن Ed11y.M (بعد استدعاء المكتبة). على سبيل المثال، في وحدة Drupal حيث جعلنا Drupal.ed11yLang اسمًا مستعارًا لحزمة اللغة:
Drupal.ed11yLang.lang.testNames.title = "Please write shorter headings."
ينطبق هذا على أيٍّ من المفاتيح الافتراضية في ملف التوطين أو في الترجمة النشطة الخاصة باللغة.
تضيف وحدة Drupal أيضًا روابط تحرير مخصصة إلى التلميحات باستخدام المعامل editLinks. لاحظ الرابطين «Page editor» و«Layout editor»:

نسخة مبسطة من الشيفرة التي تضبط هذا المعامل:
ثم تستخدم وحدة Drupal الحدث ed11yPop لإظهار رابط التحرير أو إخفائه ديناميكيًا حسب السياق عند عرض التلميحات.
يوفّر هذا الحدث مراجع للكائنين result وtip:
الاختبارات المخصصة
إذا كانت قيمة المعامل customTests رقمًا، فسيُطلق Editoria11y الحدث «ed11yRunCustomTests» أثناء الفحص، ثم يتوقف مؤقتًا لمدة تصل إلى 500 ميلي ثانية منتظرًا ذلك العدد من أحداث «ed11yResume».
يمكنك الاستفادة من ذلك لاستدعاء أي عدد تريده من السكربتات التي تحتوي على اختبارات مخصصة، بحيث تضيف نتائجها إلى مصفوفة النتائج قبل رسم التلميحات.
على سبيل المثال، إذا أردت إنشاء هذا التلميح للإشارة إلى الروابط الملصوقة من رسائل البريد الإلكتروني بعناوين URL مموّهة:

ستحتاج إلى:
- إضافة مستمع للحدث
ed11yRunCustomTests - البحث عن العناصر المطابقة
- تعريف رسالة التلميح
- إطلاق الحدث «resume» ليرسم Editoria11y التلميح: