الرئيسية المدونات ممارسات البرمجة التقنية: نهج حديث لتطوير المواقع الإلكترونية

ممارسات البرمجة التقنية: نهج حديث لتطوير المواقع الإلكترونية

التقنية مدة القراءة: 8 دقائق

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

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

أهمية الشيفرة النظيفة

الشيفرة النظيفة (Clean code) ليست مسألة ذوق في الأسلوب فحسب، بل تؤثر مباشرةً في سهولة الصيانة، وسرعة إنجاز الفريق، ويُسر انضمام الأعضاء الجدد، واستدامة الخدمات الرقمية على المدى الطويل.

إرشادات أساسية

  • استخدم أسماء معبّرة

    اختر أسماء واضحة ووصفية للمتغيرات والدوال والمكوّنات، لتسهيل قراءة الشيفرة وفهمها.

  • تجنّب التكرار

    طبّق مبدأ «لا تكرّر نفسك» (DRY: Don't Repeat Yourself) للحدّ من التكرار، والحفاظ على قاعدة شيفرة نظيفة وسهلة الصيانة.

  • قلّل تعقيد الدوال

    يُفضّل أن تؤدي كل دالة مهمة واحدة فقط؛ فالدوال الصغيرة المركّزة أسهل في تتبّع أخطائها واختبارها وإعادة استخدامها.

  • اكتب التعليقات بوعي

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

  • التزم بتنسيق موحّد

    استعن بأدوات مثل Prettier وESLint للحفاظ تلقائيًا على تنسيق موحّد للشيفرة، وتقليل الوقت اللازم لمراجعتها.

  • اجعل لكل ملف غرضًا واضحًا

    نظّم الشيفرة في ملفات ووحدات ذات أغراض محدّدة، وتجنّب الملفات المتضخّمة بتجميع المنطق المترابط والفصل بين المسؤوليات.

البنية في الشيفرة

مع نمو المنصات الرقمية، تصبح البنية عنصرًا حاسمًا في التعاون والتوسّع. فالشيفرة المنظّمة تحسّن:

  • سهولة القراءة لأعضاء الفريق الجدد
  • إمكانية التنبؤ في قواعد الشيفرة الكبيرة
  • قابلية إعادة الاستخدام والاختبار

كيف تطبّق ذلك؟

اتّبع هيكلًا قياسيًا للمجلدات. إذا كنت تبني موقعًا إلكترونيًا على نظام قائم لإدارة المحتوى (CMS)، فأنت على الأرجح تنشئ قالبًا مخصّصًا أو تصميمًا خاصًا بذلك النظام. وإليك بعض الأنماط التي يُنصح باتّباعها:

ضع «الأصول» (assets) مثل ملفات CSS وJavaScript والخطوط والصور في مجلد رئيسي واحد.

theme/
-- assets/
---- css/
---- js/
---- fonts/
---- images/
---- icons/
... etc

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

// An ideal structure for a WordPress theme
theme/
-- theme_name
---- assets/
---- includes/
------ hooks
------ modules
... etc
---- functions.php
---- header.php
---- footer.php
---- index.php
---- front-page.php
---- page.php
---- single.php
---- archives.php

احرص عند إنشاء الهيكل في React أو Vue.js على اعتماد هيكل مشابه لما يلي:

src/
├── components/      # Reusable UI elements
├── pages/           # Route-level components
├── services/        # API calls or business logic
├── hooks/           # Reusable stateful logic
├── assets/          # Images, fonts, icons
├── types/           # TypeScript definitions
├── utils/           # Utility functions

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

ومن أبرز العناصر التي ينبغي الالتزام بها في هذه المعمارية:

  • المسؤولية الواحدة

    ينبغي أن يخدم كل مكوّن غرضًا واحدًا.

  • الاستقلالية

    ينبغي أن يدير كل مكوّن حالته (state) بنفسه، ما لم تكن هذه الحالة مشتركة عبر الخصائص (props) أو السياق (context).

  • قابلية إعادة الاستخدام

    حوّل أنماط الواجهة الشائعة إلى مكوّنات متوافقة مع نظام التصميم.

  • الاختبار

    اختبر كل مكوّن ومنطقه على حدة باختبارات الوحدة (unit tests).

أنماط برمجة تدعم نظام التصميم

ينبغي للمطوّرين العاملين على المشاريع الحكومية أن يعملوا بأسلوب يعزّز البنية التي يوفّرها نظام التصميم لحكومة الإمارات، لا أن يتجاوزها.

  • ممارسة صحيحة: ارجع إلى المكوّنات الأساسية عند إنشاء وحدات جديدة.

  • ممارسة صحيحة: وسّع أنماط المكوّنات بدلًا من إعادة كتابتها.

  • ممارسة صحيحة: طبّق أدوار إمكانية الوصول وسمات ARIA مباشرةً في الشيفرة.

  • ممارسة صحيحة: نسّق مكوّنات الجهات الخارجية لتتوافق مع نظام التصميم لحكومة الإمارات.

  • ممارسة خاطئة: لا تتجاوز أنماط النظام دون حاجة.

  • ممارسة خاطئة: لا تُنشئ مكوّنات دون الاستعانة بمكتبة نظام التصميم لحكومة الإمارات.

  • ممارسة خاطئة: لا تثبّت قيم التخطيط أو الألوان مباشرةً في الشيفرة (hardcode).

  • ممارسة خاطئة: لا تُدخل مكوّنات من جهات خارجية تُخلّ باللغة البصرية للنظام.

التصميم لمختلف المتصفحات والأجهزة

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

ويضمن اتّباع هذه الإرشادات شمول الجميع، ويتوافق مع مبادئ نظام التصميم لحكومة الإمارات في إمكانية الوصول والأداء ووضع المستخدم في صميم التصميم.

دعم مجموعة واسعة من المتصفحات

يجب أن تدعم المواقع والتطبيقات الحكومية المتصفحات الشائعة والقديمة على حدّ سواء لضمان وصول جميع المستخدمين. فالالتزام بالمعايير الحديثة، مع التعامل السلس مع التقنيات الأقدم، أساسي لتحقيق الشمول الرقمي.

  • Google Chrome

    ادعم الإصدار الرئيسي الحالي والإصدار الذي يسبقه على أجهزة الحاسوب وAndroid.

  • Safari

    ادعم Safari على iOS وmacOS (آخر إصدارين رئيسيين).

  • Microsoft Edge

    ادعم متصفح Edge المبني على Chromium (الإصدار الحالي والإصدار الذي يسبقه).

  • Firefox

    ادعم الإصدار الحالي والإصدار الذي يسبقه من Firefox على أجهزة الحاسوب والهواتف المحمولة.

  • المتصفحات الحديثة

    احرص على التوافق مع المتصفحات التي تدعم ECMAScript 2015 وما بعده، وCSS Grid وFlexbox (مثل Brave وOpera).

  • التراجع السلس (Graceful degradation)

    وفّر وظائف بديلة للمتصفحات القديمة (مثل Internet Explorer 11) متى أمكن ذلك.

اعتبارات أساسية

  • لا تمنع المستخدمين من الوصول إلى الخدمة بناءً على نوع المتصفح الذي يستخدمونه.

  • اختبر التخطيطات والوظائف باستخدام مصفوفة متصفحات (browser matrix).

  • تجنّب الحلول الالتفافية الخاصة بمتصفح بعينه، واعتمد على HTML قياسي ودلالي وCSS حديث.

التصميم لأحجام الشاشات المختلفة

ابنِ تخطيطات متجاوبة تبدأ بأصغر الشاشات أولًا، ثم استخدم استعلامات الوسائط في CSS (media queries) لتكييف الواجهة مع الشاشات الأكبر.

استعلام الوسائط تقنية في CSS تستخدم القاعدة @media لإضافة مجموعة من خصائص CSS عند تحقّق شروط معيّنة. فعلى سبيل المثال، عندما يبلغ حجم الشاشة حدًّا معيّنًا، يحدّد استعلام الوسائط متى يُعرض العنصر «أ» بدلًا من العنصر «ب».

ويتكوّن استعلام الوسائط من نوع وسائط اختياري (مثل all أو handheld أو print أو TV وغيرها)، وأي عدد من التعابير الاختيارية التي تحدّد متى يُفعَّل الاستعلام، مثل العرض أو كثافة البكسل أو اتجاه الجهاز.

البدائل والتراجع السلس

ينبغي أن تظل الخدمات قابلة للاستخدام حتى إن لم تكن بعض الميزات المتقدمة مدعومة.

من التحسينات المهمة في CSS القاعدة @supports المتاحة في جميع المتصفحات الرئيسية منذ سبتمبر 2015. أما الدالة الأحدث selector()، التي تتحقق من دعم المتصفح لمحدِّد CSS معيّن، فقد أصبحت متاحة في Google Chrome منذ الإصدار 83، في حين بلغ Chrome في عام 2025 الإصدار 140. يمكنك معرفة المزيد عبر https://caniuse.com/mdn-css_at-rules_supports_selector

مثال:

1
2
3
مثال مباشر: يعتمد هذا التخطيط على CSS Grid، وفي المتصفحات التي لا تدعم Grid تحوّل القاعدة @supports not (display: grid) العناصر إلى تخطيط بسيط متراصّ عموديًا.
@supports not (display: grid) {
.layout { display: block; }
}

تعرّف على المزيد حول CSS بالتفصيل في دليلنا لأفضل ممارسات CSS.

إعطاء الأولوية للأداء على الشبكات منخفضة النطاق الترددي

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

تقنيات التحسين

  • استخدم التحميل المؤجّل (lazy loading) للصور والنصوص البرمجية
  • حسّن جميع الوسائط باستخدام صيغ مناسبة (مثل WebP وAVIF)
  • طبّق ضغط الملفات (gzip أو Brotli)
  • استخدم ترويسات تخزين مؤقت فعّالة وشبكات توصيل المحتوى (CDN)
  • قلّل الاعتماد على مكتبات JavaScript الكبيرة

أدوات الاختبار

  • Lighthouse (محاكاة شبكات 3G/4G)
  • Chrome DevTools (تبويب Throttling)
  • WebPageTest.org

ضمان دعم لوحة المفاتيح واللمس

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

قائمة التحقق

  • يجب أن يكون الوصول إلى جميع العناصر التفاعلية ممكنًا عبر لوحة المفاتيح (مفتاح Tab)
  • يجب أن تكون حالات التركيز ظاهرة ومميّزة بوضوح
  • يجب ألا تقل مساحة اللمس عن 44×44 بكسل
  • تجنّب التفاعلات التي تعتمد على تمرير المؤشر (hover) وحده

دعم اللغات والتخطيطات المختلفة

من الجوانب التي يغفل عنها المطوّرون كثيرًا طريقةُ إبلاغ المتصفح ومحركات البحث بلغة الصفحة الحالية وكيفية فهمها.

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

اتجاه المحتوى العربي

استخدم سمة الاتجاه الصحيحة للمحتوى العربي:

Apply for the service

قدّم طلب الخدمة

مثال مباشر: الصف نفسه مع dir="ltr" وdir="rtl"، إذ يتبع النص والمحاذاة والسهم اتجاه القراءة.
dir="rtl"

تحديد لغة الصفحة

حدّد لغة الصفحة في عنصر HTML الرئيسي:

<html lang="en">

أفضل ممارسات إضافية

  • اعكس التخطيط والتنقّل لمستخدمي اللغات التي تُكتب من اليمين إلى اليسار (RTL)
  • حمّل خطوطًا تدعم الحروف اللاتينية والعربية معًا
  • احرص على صحة المحاذاة والمسافات في كلا الاتجاهين