واجهات البطاقات

مثال على بطاقة إضافة

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

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

يمكن أن تكون البطاقات غير سياقية أو سياقية. تظهر البطاقات السياقية للمستخدم عندما يكون التطبيق المضيف في سياق معيّن. على سبيل المثال، عند فتح رسالة Gmail أو حدث في "تقويم Google". يتم عرض البطاقات غير السياقية (مثل الصفحات الرئيسية) للمستخدم خارج سياق محدّد للمضيف. على سبيل المثال، عندما يعرض المستخدم البريد الوارد في Gmail أو مجلد Drive الرئيسي أو "تقويم Google".

تستخدم إضافات Google Workspace التي تم إنشاؤها في "برمجة تطبيقات Google" خدمة البطاقات لإنشاء واجهات مستخدم من بطاقات. يجب أن تعرض الإضافات المكتوبة بلغات أخرى ملف JSON منسَّقًا بشكل صحيح لكي يتم عرض الواجهة على شكل بطاقات.

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

تتضمّن الواجهات المستندة إلى البطاقات المزايا التالية:

  • لا تحتاج إلى معرفة HTML أو CSS لإنشاء واجهات مستندة إلى البطاقات.
  • يتم تصميم البطاقات والأدوات تلقائيًا لتتوافق مع تطبيقات Google Workspace التي توسّع نطاقها.

  • تعمل الواجهات المستندة إلى البطاقات على كلّ من أجهزة الكمبيوتر والأجهزة الجوّالة، ولكن ما عليك سوى تحديد الواجهة مرة واحدة.

إنشاء واجهات مستندة إلى البطاقات

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

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

  • دليل البدء السريع لإضافة "القطط" في Google Workspace

    يعرض نموذج الإضافة هذا واجهة مستخدم بسيطة لإضافة Google Workspace تتضمّن صفحات متعددة وصفحات رئيسية.

  • إضافة Google Workspace: "ترجمة"

    يعرض نموذج الإضافة هذا إضافة Google Workspace تتيح للمستخدمين ترجمة النص من داخل "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google".

  • إضافة Google Workspace: "قائمة الفرق"

    يعرض نموذج الإضافة هذا نموذجًا أكثر تعقيدًا لإضافة Google Workspace، وهو يعرض معلومات المستخدمين حول مستلمي رسائل Gmail أو محرّري ملفات Drive أو ضيوف أحداث "تقويم Google". يمكنك استخدام هذه الإضافة داخل نطاق فقط، لأنّها تستخدم Directory API لاسترداد معلومات المستخدم.