البطاقات

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

بنية البطاقة

البطاقة هي مجموعة من عناصر واجهة المستخدم التي تصمّمها. تتألّف البطاقة من الأقسام التالية:

• عنوان البطاقة: يحدد هذا المعرّف البطاقات. ويحتوي على نص العنوان، وقد يتضمّن بشكل اختياري عنوانًا فرعيًا ورمزًا.

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

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

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

استخدام بطاقات متعددة

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

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

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

لأسباب تتعلّق بالأداء، لا يمكنك إضافة أكثر من 100 تطبيق مصغّر أو 100 قسم بطاقة إلى بطاقة واحدة.