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

تستند إضافات Google Workspace إلى البطاقات. تستند إضافات المحرّر إلى HTML.

مثال على واجهة بطاقة إضافة Google Workspace

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

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

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

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

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

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

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

‫Gmail هو تطبيق المضيف الوحيد الذي يمكن توسيعه باستخدام إضافات Google Workspace على الأجهزة الجوّالة.

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

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

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

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

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

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

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

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

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