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

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

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

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

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

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

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

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

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

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

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

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

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