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

المحتوى

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

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

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

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

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

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

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

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

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

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

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

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