التأكد من تطبيق النسخة 1.0 من نظام التصميم الموحد (كود المنصات)
يطلب هذا المعيار أن تُبنى واجهات المنصة على مكتبة كود المنصات نفسها لا على نسخة مشابهة منها. ويُقاس باستخراج أثر المكتبة من الصفحات المفحوصة: وسوم العناصر المخصّصة dga-*، ومتغيرات CSS ذات البادئة --dga-*، وأسماء أصناف مكتبة React الرسمية. فإن وُجد الأثر عميقًا عُدّ المعيار مطبقًا، وإن وُجد لونًا واحدًا مستعارًا دون سواه فتلك استعارة قيمة لا تبنٍّ للنظام. والعنصر المبني يدويًا قد يطابق الشكل اليوم ولا تصل إليه تحديثات المكتبة غدًا.
وهو من المعايير الأساسية في فئة الأساسات من دليل كود المنصات، نظام التصميم الموحد للمملكة، الصادر عن هيئة الحكومة الرقمية.
كيف تقيس الأداة هذا المعيار
تُقرأ القيمة المطبَّقة من الصفحة وتُقارن بالقيمة المعتمدة في كود المنصات، فيصدر الحكم عن قياس لا عن تقدير، وتُرفق القيمة المرصودة والقيمة المتوقعة معًا.
النص الرسمي ونقاط التحقق
لم تنشر هيئة الحكومة الرقمية نقاط تحقق تفصيلية لهذا المعيار، ونص المعيار نفسه هو المرجع عند الحكم عليه.
صفحة هذا المعيار في الموقع الرسمي لكود المنصاتكيف تتحققون منه يدويًا
وهذه خطوات المراجعة الكاملة للمعيار، وبعضها أوسع مما تغطيه القاعدة الآلية اليوم.
- افتحوا أدوات المطور واختاروا زرًا رئيسيًا أو حقل إدخال، ثم انظروا في شجرة العناصر: المكوّن المستدعى من المكتبة يظهر بوسم يبدأ بـ dga- مثل dga-button
- افحصوا :root بحثًا عن متغيرات تبدأ بـ --dga-. وجود عدد قليل منها استعارة قيم، ووجودها بالعشرات تبنٍّ فعلي للنظام
- ابحثوا في أسماء الأصناف عن النمط dga- أو dga_، فهي أثر مكتبة React الرسمية
- كرروا الفحص على ثلاث صفحات مختلفة على الأقل، إذ تعتمد بعض المنصات المكتبة في الصفحة الرئيسية وحدها دون بقية المسارات
- العلامة الفارقة: مكوّن يطابق شكل النظام تمامًا ولا يحمل أيًّا من الآثار الثلاثة السابقة. ذلك بناء يدوي، وهو ما يفسّر أغلب حالات التطبيق الجزئي
أخطاء شائعة في هذا المعيار
| الخطأ | لماذا يضر |
|---|---|
| إعلان الالتزام مع بناء العناصر يدويًا | |
| التطابق البصري دون استخدام المكتبة | |
| استعارة متغيرات الألوان وحدها دون المكوّنات | استعارة قيمة لا تبنٍّ للنظام |
| اعتماد المكتبة في صفحة أو صفحتين دون بقية المنصة | |
| فصل المكوّن عن المكتبة بعد استدعائه | فينقطع عن تحديثاتها ويبتعد عنها مع كل إصدار |
كيف يُعالَج
- ابدأوا بمكوّن واحد عالي التكرار، كالزر أو حقل الإدخال، واستبدلوه من المكتبة في كل مواضعه قبل الانتقال إلى غيره
- لا تفصلوا المكوّن عن المكتبة لتعديله. وإن لزم تعديل لا تحتمله المكتبة فارفعوا الحاجة إلى فريق التبنّي بدل الفصل
- ثبّتوا إصدار المكتبة في ملف الاعتماديات، وارفعوه بقرار مراجَع لا بتحديث تلقائي
- امنعوا في مراجعة الشيفرة أي مكوّن جديد يعيد بناء ما في المكتبة، فالمنع أرخص من الاستبدال لاحقًا
- أعيدوا القياس بعد كل مكوّن مستبدل، إذ يرتفع أثر هذا المعيار على بقية المعايير مع كل استبدال
معايير متصلة
وفي الدليل: كود المنصات: الدليل الشامل لنظام التصميم الموحد ومعاييره الستة والخمسين · الدليل الشامل يبدأ من هذا المعيار، إذ يقرر أثره على بقية المعايير
طبّقته ٣٪ من ٢٩ منصة حكومية مقيسة
- ٢٩ منصة
- ٢٩ منصة
- ٢٩ منصة
والقياس على عيّنة من المنصات المنشورة للعموم بالمنهجية نفسها المنشورة في صفحة المنهجية.
أين تقف منصتكم من هذا المعيار؟
يصدر الفحص تقديرًا استرشاديًا خلال دقائق، ويبيّن لكل ملاحظة قيمتها المرصودة والمتوقعة وموضعها.