كود المنصات pdf · وثيقة توضيح المعايير، وما تجدونه فيها

وثيقة كود المنصات منشورة مجانًا في الموقع الرسمي لنظام التصميم الموحد، ولا يحتاج تحميلها إلى تسجيل ولا إلى وسيط. وهي النص المرجعي للمعايير ونقاط التحقق، تصف ما ينبغي أن يكون عليه التصميم، ولا تكشف أين خالفته منصة بعينها. وإلى جانبها أصلان آخران لا يغني عنهما الملف: مكتبة التصميم على Figma، ومكتبة الشيفرة.

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

جمعنا ملف توضيح المعايير الرسمي المنشور على figma في ملف pdf واحد، ونشرناه هنا لتيسير الرجوع إليه:

تحميل وثيقة توضيح معايير كود المنصات · pdf

وثلاثة أمور يلزم قولها عنه بوضوح قبل أي شيء:

1. الملف مجمَّع من المصدر الرسمي، وليس إصدارًا رسميًا. المرجع المعتمد هو ما تنشره هيئة الحكومة الرقمية وحدها، وهذا تيسير للرجوع لا بديل عنه.
2. صور لا نصًا. الصفحات لقطات من ملف التصميم، فلا يمكن البحث داخلها ولا نسخ نص منها، ولا يقرؤها قارئ الشاشة. ولذلك تجدون مضمونها مكتوبًا نصًا في هذه الصفحات لا في الملف وحده.
3. الأصل يُحدَّث والنسخة لا. عند أي اختلاف، النسخة الرسمية هي الحاكمة.

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

وتغطية الملف تتبع بنية الكود: ٥٦ معيارًا على ست فئات، منها ٤٣ معيارًا أساسيًا و١٣ ثانويًا، تتفرع إلى ١٢٧ نقطة قبول متمايزة.

وأدق ما فيه المقاسات: نصف قطر الحواف، والمسافة الداخلية، وارتفاع الحقل، ومساحة اللمس. وهذه بالذات ما لا يُنقل بالنظر، وما يسقط عادةً عند إعادة البناء يدويًا.

1. الخط IBM Plex Sans Arabic بأوزانه الأربعة، ومتغيّرات العرض منفصلة عن متغيّرات النصوص · معيار ٣
2. سلّم المسافات بمضاعفاته الثابتة من 4px · معيار ٤
3. مساحة اللمس لا تقل عن 44px في كل عنصر تفاعلي
4. نسبة التباين لا تقل عن 4.5:1 للنص، مع قيم On-Color للنص على خلفية ملونة · معيار ٢
5. موضع الختم الرقمي أعلى الصفحة فوق شريط التنقل العلوي، لا في التذييل · معيار ١١

الوثيقة تصف الصواب، ولا تكشف موقعكم منه. وهذا الفرق ليس نظريًا.

ففي قياس عيّنة من المنصات الحكومية بلغت ٢٩ منصة، ظهر أن ٢٥ معيارًا من ٢٨ معيارًا مقيسًا يقع معدل التطبيق الكلي فيها بين ٠٪ و٥٪، بينما يتراوح التطبيق الجزئي في المعايير نفسها بين ٤٥٪ و١٠٠٪، ويتجاوز ٩٠٪ في ستة عشر منها.

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

لأن المسافة بين المواصفة والتنفيذ لا تُقطع بالقراءة:

الفارق أصغر من أن تلتقطه العين. لون يبعد درجتين عن المعتمد، وpadding أقل ببضعة بكسلات يكسر مساحة اللمس، ونصف قطر يزيد 2px. كلها تجتاز المراجعة البصرية وتسقط في القياس.

النطاق أكبر من أن يُمسح يدويًا. المنصة عشرات الصفحات على ثلاثة مقاسات، والمكوّن الواحد يظهر بأشكال مختلفة في مواضع مختلفة.

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

إلى جانب التوضيح المصوَّر، ينشر الكود مكتبة مكوّنات جاهزة. وأصل المكتبة أهم عمليًا من أي ملف مرجعي، إذ إن معيار ١ يقيس استعمالها لا معرفتها، وقد بلغ التطبيق الكلي فيه ٥٪ فقط في العيّنة.

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

وتفصيل ملف التصميم نفسه في كود المنصات figma، وترتيب المعالجة في خطوات تطبيق كود المنصات.

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

كود المنصات ثلاثة أصول لا أصل واحد:

1. الوثيقة والموقع · النص المرجعي للمعايير ونقاط التحقق
2. ملف التصميم على Figma · المكوّنات بحالاتها والقيم المعتمدة، وتفصيله في كود المنصات figma
3. مكتبة الشيفرة · مكوّنات جاهزة مع دليل تفاعلي لمعاينتها

وتُقبل أطر عمل أخرى. المكتبة الرسمية للشيفرة ليست شرطًا في ذاتها، والمطلوب مطابقة المواصفة. غير أن إعادة البناء بإطار آخر تعيد الفريق إلى الحالة التي جاءت بها أرقام القياس.