تعرِض إضافات Google Workspace معلومات وعناصر تحكّم للمستخدِم في الشريط الجانبي لواجهة مستخدم التطبيق المضيف. تتألّف الإضافة من شريط أدوات رئيسي لتحديد المصدر مع بطاقة واحدة أو أكثر.
تمثّل كل بطاقة "صفحة" معيّنة من واجهة مستخدم الإضافة، وعادةً ما يتم الانتقال إلى بطاقة جديدة من خلال إنشاء تلك البطاقة ودفعها إلى حزمة بطاقات داخلية. يمكنك تحديد مسارات التنقّل بين البطاقات للحصول على تجربة تفاعلية غنية.
يمكن أن تكون البطاقات غير سياقية أو سياقية. يتم عرض البطاقات السياقية للمستخدم عندما يكون التطبيق المضيف في سياق معيّن. على سبيل المثال، عند فتح رسالة في Gmail أو حدث في "تقويم Google". يتم عرض البطاقات غير السياقية (مثل الصفحات الرئيسية) للمستخدم خارج سياق معيّن للمضيف. على سبيل المثال، عندما يكون المستخدم بصدد عرض البريد الوارد في Gmail أو مجلد Drive الرئيسي أو "تقويم Google".
تستخدم إضافات Google Workspace التي تم إنشاؤها في Apps Script خدمة البطاقات لإنشاء واجهات مستخدم من البطاقات. يجب أن تُعرِض الإضافات المُنشأة بلغات أخرى ملف JSON بتنسيق صحيح لكي يتم عرض الواجهة على شكل بطاقات.
تتألّف كل بطاقة من عنوان وقسم واحد أو أكثر من أقسام البطاقة. يتكون كل قسم من مجموعة من تطبيقات المصغّرة. تعرِض التطبيقات المصغّرة معلومات للمستخدم أو توفّر عناصر تحكّم في التفاعل، مثل الأزرار.
توفّر الواجهات المستندة إلى البطاقات المزايا التالية:
- لا يلزم معرفة HTML أو CSS لإنشاء واجهات مستندة إلى البطاقات.
- يتم تلقائيًا تصميم البطاقات والتطبيقات المصغّرة للعمل بشكل جيد مع تطبيقات Google Workspace التي تضيف إليها ميزات إضافية.
تعمل الواجهات المستندة إلى البطاقات على كلٍّ من أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة، ولكن تحتاج فقط إلى تحديد الواجهة مرّة واحدة.
إنشاء واجهات مستندة إلى البطاقات
عند إنشاء إضافات مستندة إلى البطاقات، من المهم فهم بعض المفاهيم وأنماط التصميم. تقدّم الأدلة التالية المعلومات التي تحتاج إليها لإنشاء إضافات مستندة إلى البطاقات بفعالية:
- البطاقات
- الصفحات الرئيسية
- التطبيقات المصغَّرة
- الإجراءات
- عناصر الأحداث
- إنشاء البطاقات
- إنشاء بطاقات تفاعلية
- التنقّل بين البطاقات
- استخدام الإجراءات الشاملة
- إضافة ميزة الإكمال التلقائي إلى إدخالات النصوص
- الوصول إلى لغات المستخدمين ومناطقهم الزمنية
- الاتصال بخدمات غير تابعة لشركة Google
- دليل الأسلوب
- أفضل الممارسات
يمكنك الرجوع إلى هذه الصفحات عند إنشاء البطاقات وتنفيذ سلوك واجهة المستخدم. قد تكون النماذج الإضافية التالية مفيدة أيضًا عند الرجوع إليها عند تنفيذ الإضافة:
البدء السريع لإضافات Google Workspace "Cats"
يعرض نموذج الإضافة هذا واجهة مستخدم بسيطة لإضافات Google Workspace تتضمّن صفحات ومقدّمات صفحات متعددة.
إضافة Google Workspace: "ترجمة"
يعرض نموذج الإضافة هذا إضافة Google Workspace تتيح للمستخدمين ترجمة النص من داخل "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google".
إضافة Google Workspace: "قائمة الفِرق"
يعرض نموذج الإضافة هذا نموذجًا أكثر تعقيدًا لإضافة Google Workspace، والذي يعرض معلومات المستخدمين عن مستلمي رسائل Gmail أو محرِّري ملفات Drive أو الضيوف في أحداث "تقويم Google". لا يمكنك استخدام هذه الإضافة إلا داخل نطاق، لأنّه تستخدِم Directory API لاسترداد معلومات المستخدم.