التأكد من الحفاظ على نهج ثابت في كيفية التعامل مع الأخطاء وعرضها عبر التطبيق/الموقع لضمان تجربة مستخدم سلسة.
يطلب نهجًا واحدًا في التعامل مع الأخطاء وعرضها عبر المنصة: الموضع نفسه، والأسلوب نفسه، ورسالة تقول ما حدث وما الخطوة التالية.
وهو من المعايير الأساسية في فئة التجربة من دليل كود المنصات، نظام التصميم الموحد للمملكة، الصادر عن هيئة الحكومة الرقمية.
كيف تقيس الأداة هذا المعيار
يقبل هذا المعيار القياس الآلي، ولم تُبنَ له قاعدة في الأداة بعد، فلا يحتسبه الفحص لا سلبًا ولا إيجابًا، ويعرضه التقرير باسمه وحالته. وخطوات التحقق اليدوي أدناه تغطيه كاملًا حتى تُبنى القاعدة.
النص الرسمي ونقاط التحقق
يقوم هذا المعيار على ٣ من نقاط التحقق المنشورة في كود المنصات، وهي المرجع عند الحكم عليه.
نقاط التحقق، نقطة نقطة
لكل نقطة من نقاط التحقق أدناه إجابة مستقلة: ما تشترطه، وما الذي يجتازها وما الذي يسقط فيها، وكيف تُقاس أو يُتحقق منها، وكيف تُعالَج. ولكل نقطة رابط مباشر يمكن مشاركته.
ثبات نمط عرض الخطأ بصريًا ومكانيًا في السياق الواحد
لم تُبنَ له قاعدة بعدDGA-043-aتشترط هذه النقطة عرض الأخطاء بالنمط البصري والمكاني نفسه داخل السياق الواحد، فتظهر أخطاء حقول النموذج الواحد بالشكل نفسه وفي الموضع نفسه من كل حقل. فاختلاف الموضع بين حقل وآخر يجعل المستخدم يبحث عن الخطأ في كل مرة.
يقبل هذا المعيار القياس الآلي ولم تُبنَ للنقطة قاعدة في الأداة بعد، فلا يحتسبها الفحص لا سلبًا ولا إيجابًا.
ما الذي يجتازها: رسالة الخطأ تحت الحقل مباشرة في كل حقول النموذج، بلون ومقاس واحد، ومرتبطة بحقلها برمجيًا.
ما الذي يسقط فيها: خطأ حقل أعلى النموذج وخطأ حقل آخر تحته، فيتعذّر على المستخدم بناء توقّع عن موضع الرسائل.
كيف تُقاس أو يُتحقق منها: تُقرأ مواضع رسائل الخطأ وارتباطها بالحقول من بنية الصفحة حين تكون معروضة. وإظهارها بالإرسال ممنوع على منصات الجهات، فيتحقق منها فريقكم.
كيف تُعالَج: وحّدوا موضع رسالة الخطأ في مكوّن الحقل نفسه، فيصير الاتساق أثرًا للبنية لا نتيجة انضباط يدوي.
نقاط متصلة:صياغة رسائل الخطأ: ما المشكلة وما طريقة حلها ·وضوح الرسائل وإيجازها واتساق أسلوبها اللغوي ·نصوص التلميح والنصوص المساعدة ورسائل الخطأ في المدخلات
صياغة رسائل الخطأ: ما المشكلة وما طريقة حلها
لم تُبنَ له قاعدة بعدDGA-043-bتشترط هذه النقطة أن تتبع رسائل الخطأ صياغة واضحة متسقة تسهّل على المستخدم فهم المشكلة وطريقة حلها. فالرسالة التي تعلن وقوع خطأ دون أن تسمّيه ودون أن تدل على المخرج نصف رسالة.
يقبل هذا المعيار القياس الآلي ولم تُبنَ للنقطة قاعدة في الأداة بعد، فلا يحتسبها الفحص لا سلبًا ولا إيجابًا.
ما الذي يجتازها: رسالة تسمّي المشكلة وتذكر الخطوة التالية، مثل بيان الصيغة المطلوبة للحقل الذي رُفض.
ما الذي يسقط فيها: رسالة عامة تقول إن شيئًا لم يتم دون تسمية الحقل ولا السبب، فيعيد المستخدم المحاولة بلا تغيير.
كيف تُقاس أو يُتحقق منها: يحكم النموذج اللغوي على وضوح الرسائل المرصودة بثقة مقيّدة، ضمن حكم اللغة على المنصة. والرسائل التي لا تظهر إلا بالإرسال خارج متناول الزحف.
كيف تُعالَج: أعيدوا كتابة كل رسالة على قالبين: ما المشكلة، وما الخطوة التالية. وابدأوا برسائل نماذج التسجيل فهي الأكثر ورودًا.
نقاط متصلة:وضوح الرسائل وإيجازها واتساق أسلوبها اللغوي ·ثبات نمط عرض الخطأ بصريًا ومكانيًا في السياق الواحد ·استعمال الإشعار في سياقه المحدد
وضوح الرسائل وإيجازها واتساق أسلوبها اللغوي
لم تُبنَ له قاعدة بعدDGA-043-cتشترط هذه النقطة أن تكون صياغة الرسائل واضحة موجزة مسترشدة بأسلوب لغوي موحد، فيفهم المستخدم الإجراء أو المشكلة دون عناء. والاتساق هنا في الأسلوب لا في المحتوى وحده: رسائل بصيغ خطاب مختلفة تُقرأ كأنها من منصات مختلفة.
يقبل هذا المعيار القياس الآلي ولم تُبنَ للنقطة قاعدة في الأداة بعد، فلا يحتسبها الفحص لا سلبًا ولا إيجابًا.
ما الذي يجتازها: رسائل النجاح والخطأ بصيغة خطاب واحدة ونبرة واحدة عبر المنصة كلها.
ما الذي يسقط فيها: رسالة بصيغة الأمر وأخرى بصيغة الاعتذار وثالثة بصيغة التقرير في المنصة نفسها، فتختلف نبرة النظام من شاشة إلى شاشة.
كيف تُقاس أو يُتحقق منها: يحكم النموذج اللغوي على اتساق النبرة والأسلوب عبر نصوص الصفحات بثقة مقيّدة، وهو أحد ثلاثة معايير لغوية يقرؤها عند كل فحص.
كيف تُعالَج: اختاروا صيغة خطاب واحدة والتزموها في كل الرسائل، واجمعوها في ملف واحد بدل كتابتها في مواضعها.
نقاط متصلة:صياغة رسائل الخطأ: ما المشكلة وما طريقة حلها ·إزالة التكرار وتعدد التعبيرات عن المعنى الواحد ·رسالة تأكيد استلام الملاحظات بعد الإرسال
كيف تتحققون منه يدويًا
وهذه خطوات المراجعة الكاملة للمعيار، وبعضها أوسع مما تغطيه القاعدة الآلية اليوم.
- أطلق أخطاء تحقق متعمدة في النماذج (إرسال فارغ، بريد غير صالح، ملف > 2MB) والتقط:
- قارن الأنماط عبر الحقول والنماذج ⇒ اختلاف الموضع/النمط لنفس السياق = مخالفة النقطة 1
- تحقق من
aria-invalidوaria-describedby(يتقاطع مع معيار 34) - علم أحمر: رسائل تقنية خام (Error 500, NullReferenceException) أو غامضة («حدث خطأ»)
- صفحات الخطأ 404/500 تستخدم قالب النظام
أخطاء شائعة في هذا المعيار
| الخطأ | لماذا يضر |
|---|---|
| يختلف موضع رسالة الخطأ ونمطها بين نموذج وآخر في المنصة نفسها | |
| تظهر رسائل تقنية خام للمستخدم بدل رسائل مفهومة | |
| تخرج صفحتا الخطأ عن قالب النظام | فتبدوان من موقع آخر. |
يغيب aria-invalid عن الحقول التي وقع فيها الخطأ | |
| لا يُبقي النظام ما أدخله المستخدم بعد وقوع الخطأ | فيعيد الإدخال من أوله. |
ما يرفقه التقرير مع كل ملاحظة
لقطات لكل حالة خطأ + جدول مقارنة الموضع/النمط/النص
كيف يُعالَج
- وحّدوا موضع رسالة الخطأ ونمطها عبر كل النماذج.
- أخفوا الرسائل التقنية واستبدلوها برسائل تقول الإجراء المطلوب.
- ابنوا صفحتي الخطأ من قالب النظام.
- أضيفوا
aria-invalidوaria-describedbyلكل حقل يقع فيه خطأ. - احفظوا مدخلات المستخدم عند وقوع الخطأ.
معايير متصلة
وفي الدليل: كيف تحافظون على الالتزام بكود المنصات بعد تطبيقه · نهج الأخطاء يثبت بالصيانة عبر النماذج الجديدة
أين تقف منصتكم من هذا المعيار؟
يصدر الفحص تقديرًا استرشاديًا خلال دقائق، ويبيّن لكل ملاحظة قيمتها المرصودة والمتوقعة وموضعها.