تم إعداد دليل الأسلوب هذا لمساعدتك على اتخاذ القرارات بشأن كيفية إعداد النماذج لمعرض نماذج المنتدى. ويستند دليل الأسلوب هذا إلى مبادئ الكتابة في التصميم متعدد الأبعاد من Google. بعبارة بسيطة، هذه هي:
- كن موجزًا
- الكتابة ببساطة ومباشرة
- مخاطبة المستخدمين بوضوح
- مشاركة التفاصيل الأساسية
- الكتابة لجميع مستويات القراءة
- كن إنسانيًا: اكتب للبشر وليس برامج الروبوت
اتبع هذه الإرشادات للمساعدة في التأكد من أن جميع النماذج تتمتع بشكل وأسلوب متناسق، ولمساعدة المستخدمين على فهم كيفية استخدام النموذج.
معلومات
تنطبق هذه الإرشادات على العناصر الموجودة في علامة التبويب معلومات في محرر النماذج.
الاسم
يتم تقديم اسم النموذج لمستخدمي "إدارة العلامات" من خلال واجهة مستخدم "إدارة العلامات" ومعرض نماذج المنتدى. وتظهر أعلى صفحة تفاصيل النموذج، وتظهر عند سرد النماذج.
- استخدم اسم شركتك/مؤسستك واسم وظيفي للنموذج: اسم المؤسسة اسم النموذج.
- استخدِم حالة أحرف العنوان.
- استخدم المصطلحات التي تصف الوظائف.
- تجنب استخدام المصطلح "رسمي" في أسماء النماذج، ما لم يتم السماح لك بذلك من قِبل المؤسسة المعنية.
أمثلة: علامة قياس الإحالات الناجحة في MyCompany، ومتغير رقم تعريف حملة MyCompany
الوصف
وصف النموذج هو وصف للنموذج يظهر في صفحات التفاصيل كملخص موجز لوظائف النموذج.
- استخدم جملاً واضحة وموجزة لوصف ما يفعله النموذج.
- اذكر بوضوح كيف يفيد النموذج المستخدم. على سبيل المثال: "يمكن أن يساعدك نموذج أداة إنشاء الجمهور في Example.com في إنشاء قوائم مستخدمين جديدة من زوّار موقع الويب".
- تجنّب اللغة الاصطلاحية.
- تضمين روابط للحصول على معلومات ووثائق ودعم إضافي.
الرمز
يتمّ تمثيل رمز النموذج كصورة مصغّرة عند إدراجه في أداة "إدارة العلامات من Google" وفي "معرض نماذج المنتدى".
- استخدم تنسيق PNG أو JPEG أو GIF لتنسيق الصورة.
- يجب أن تكون الصورة مربّعة وبحجم لا يقلّ عن 48 × 48 بكسل وألا تزيد عن 96 بكسل × 96 بكسل.
- يجب أن يكون حجم الملف أقل من 50 كيلوبايت.
- تجنَّب استخدام شعارات الشركات الرسمية، ما لم يتم منحك تفويضًا بذلك من قِبل المؤسسة المعنية.
- الحقول
- استخدم علامة التبويب الحقول في محرر النماذج لإضافة عناصر النموذج مثل إدخال النص ومربعات الاختيار، وما إلى ذلك.
الحقول
تنطبق إرشادات النمط هذه على علامة التبويب الحقول في محرر النماذج.
اسم المعلَمة
هذا هو اسم الحقل كما يظهر في محرر النماذج، ولكن ليس كما يظهر للمستخدم. يجب أن تصف الأسماء نوع البيانات المستخدمة. يجب تنسيق أسماء المعلَمات على أنها lowerCamelCase. أمثلة: userName، customerID، shoppingCartValue.
تصنيفات الحقول
تتضمن تصنيفات الحقول حقول اسم العرض ونص مربع الاختيار والعناصر ذات الصلة.
- استخدِم حالة أحرف الجملة.
- الأقصر هو الأفضل.
- استخدم عبارات وصفية.
- استخدم الكلمات الشائعة.
نص المساعدة
نص المساعدة هو محتوى إعلامي، يظهر كتلميح، لمساعدة المستخدم في إدخال قيمة صالحة في حقل النموذج. قدِّم مثالاً على الإدخال، إن أمكن، ووصف كيفية استخدام حقل النموذج أو تأثير تقديم قيم معيّنة.
- استخدِم حالة أحرف الجملة.
- كن مقتضبًا، ولكن يجب أن تكون إنسانيًا. لا بأس باستخدام الانقباضات والكتابة مع الشخص الثاني (أنت).
- أنواع الحقول المتوافقة
- مسموح بتنسيق HTML الأساسي. أمثلة:
<strong>،<em>.
أنواع الحقول المتوافقة
النوع |
الوصف |
|---|---|
| إدخال النص | إدخال النص. ستكون قيمة معلمة النموذج من هذا النوع سلسلة قد تشير إلى المتغيرات. يمكن أن تكون أداة إدخال النص المعروضة في واجهة مستخدم "إدارة العلامات" إما حقل نص من سطر واحد أو إدخالاً متعدد الأسطر. |
| القائمة المنسدلة | قائمة منسدلة يمكن فيها تحديد عنصر واحد فقط كقيمة لمعلمة النموذج. اسرد العناصر حسب الترتيب الأبجدي ما لم يكن هناك سبب وجيه لإجراء ذلك. |
| مربّع اختيار | مربع اختيار الإدخال. ستكون قيمة معلمة النموذج من هذا النوع منطقية: true for selected، وfalse لإلغاء التحديد. |
| زر الاختيار | إدخال لاسلكي. توفر معلمة النموذج من هذا النوع قائمة بالخيارات في واجهة مستخدم إدارة العلامات، ولا يُسمح للمستخدم إلا باختيار أحد الخيارات كقيمة معلمة النموذج. |
| جدول بسيط | إدخال جدول بسيط. يمكن تعديل كل خلية في الجدول في مكانها، ويمكن أن تتكون كل خلية من نوعين فقط: إدخال نصي أو قائمة منسدلة. وتكون قيمة معلمة النموذج من هذا النوع مصفوفة من العناصر: حيث يشفر كل كائن صفًا، بينما يكون كل مفتاح في الكائن واحدًا من أسماء الأعمدة، وكل قيمة في الكائن هي قيمة الخلية المقابلة. |