تظهر الإضافة المستندة إلى البطاقة كعمود في الشريط الجانبي (أو على الأجهزة الجوّالة، كأحد
نوافذ الأنشطة الأخرى التي يمكن الوصول إليها من خلال القائمة). تحتوي الإضافة على شريط أدوات في أعلى الشاشة يحدد الإضافة ويعرض بطاقة، وهي في الأساس "صفحة" من واجهة مستخدم الإضافة. تمثّل Apps Script البطاقات في رمز المشروع باستخدام عناصر
Card.
بنية البطاقة
البطاقة هي مجموعة من عناصر واجهة المستخدم التي صمّمتها. تتألّف البطاقة من القسمين التاليين:
- عنوان البطاقة يحدِّد هذا الإجراء البطاقات. يتضمّن نص العنوان، وقد يحتوي اختياريًا على عنوان فرعي ورمز.
قسم بطاقة واحد أو أكثر هذه هي التقسيمات الفرعية لمساحة واجهة المستخدم في البطاقة. قد يتضمّن القسم عنوانًا نصيًا اختياريًا. يتم فصل أقسام البطاقة عن بعضها البعض على البطاقة بواسطة خط أفقي. إذا كان قسم البطاقة كبيرًا بشكل خاص، يتم عرضه تلقائيًا كقسم قابل للطي يمكن للمستخدمين توسيعه أو تصغيره حسب الحاجة. يمكن أن تتضمّن البطاقة ما لا يزيد عن 100 قسم بطاقة، ويجب أن تتضمّن بضع أقسام فقط لتحقيق أداء أفضل.
يحتوي كل قسم من أقسام البطاقة على عنصر واجهة مستخدم واحد أو أكثر مكوّن عرض. توفّر التطبيقات المصغّرة للمستخدم معلومات أو عناصر تحكّم تفاعلية. إنّ البطاقات وأقسام البطاقات هي تطبيقات مصغّرة هيكلية، لذا لا يمكنك إضافتها إلى قسم بطاقة. يمكن أن يتضمّن قسم البطاقة ما لا يزيد عن 100 تطبيق مصغّر، ويجب أن يكون بسيطًا قدر الإمكان لتحقيق أفضل أداء.
يجب تصميم البطاقات استنادًا إلى أنشطة مستخدمين أو مجموعات بيانات معيّنة. على سبيل المثال، قد تحتوي إضافة Google Workspace التي تعرض بيانات مأخوذة من "جداول بيانات Google" على بطاقة منفصلة لكل ورقة بيانات تسحب البيانات منها.
استخدام بطاقات متعددة
تتألف الإضافات عادةً من أكثر من بطاقة واحدة. يمكنك ضبط هذه البطاقات كقائمة بسيطة لالتنقّل الأساسي باستخدام بطاقات متعددة، أو ضبط طُرق تنقّل أكثر تعقيدًا للتحكّم في كيفية تنقّل المستخدم بين البطاقات.
إذا كانت الإضافة تستخدِم التنقّل الأساسي، عند فتح الإضافة لأول مرة، ينشئ تطبيق Google Workspace الذي تُوسّعه الإضافة قائمة برؤوس البطاقات ويعرضها للمستخدم. يؤدي النقر على عنوان البطاقة إلى فتحها. يتوفّر أيضًا سهم للرجوع إلى قائمة عناوين البطاقة. لست بحاجة إلى ترميز وظائف الرأس وسهم الرجوع، ويتم ذلك تلقائيًا عند تحديد البطاقات في الإضافة.
عند تصميم الإضافات، من الأفضل حصر عدد البطاقات التي تعرضها في الوقت نفسه، لأنّ البطاقات يجب أن تشترك في مساحة محدودة من الشاشة. من الأفضل أيضًا تجنُّب التعقيد غير الضروري في البطاقات.