تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تظهر الإضافة المستندة إلى البطاقة كعمود في الشريط الجانبي (أو على الأجهزة الجوّالة، كأحد
نوافذ الأنشطة الأخرى التي يمكن الوصول إليها من خلال القائمة). تحتوي الإضافة على شريط أدوات في أعلى الصفحة يحدد الإضافة ويعرض بطاقة، وهي في الأساس "صفحة" من واجهة مستخدم الإضافة. تمثّل Apps Script البطاقات في رمز المشروع باستخدام عناصر
Card.
بنية البطاقة
البطاقة هي مجموعة من عناصر واجهة المستخدم التي صمّمتها. تتألّف البطاقة من القسمين التاليين:
عنوان البطاقة يحدِّد هذا الإجراء البطاقات. يتضمّن نص العنوان، وقد يحتوي
اختياريًا على عنوان فرعي ورمز.
قسم بطاقة واحد أو أكثر هذه هي التقسيمات الفرعية لمساحة واجهة المستخدم في البطاقة.
قد يتضمّن القسم عنوانًا نصيًا اختياريًا.
يتم فصل أقسام البطاقة عن بعضها البعض على البطاقة بواسطة خط أفقي.
إذا كان قسم البطاقة كبيرًا بشكل خاص، يتم عرضه تلقائيًا كقسم
قابل للطي يمكن للمستخدمين توسيعه أو تصغيره حسب الحاجة.
يمكن أن تتضمّن البطاقة ما لا يزيد عن 100 قسم بطاقة،
ويجب أن تتضمّن بضع أقسام فقط لتحقيق أداء أفضل.
يحتوي كل قسم من أقسام البطاقة على عنصر واجهة مستخدم واحد أو أكثر
. توفّر التطبيقات المصغّرة للمستخدم
معلومات أو عناصر تحكّم تفاعلية. إنّ البطاقات وأقسام البطاقات هي تطبيقات مصغّرة
هيكلية، لذا لا يمكنك إضافتها إلى قسم بطاقة. يمكن أن يتضمّن قسم البطاقة
100 تطبيق مصغّر كحد أقصى،
ويجب أن يكون بسيطًا قدر الإمكان لتحقيق أفضل أداء.
يجب تصميم البطاقات استنادًا إلى أنشطة مستخدمين أو مجموعات بيانات معيّنة. على سبيل المثال، قد تحتوي إضافة Google Workspace التي تعرض بيانات مأخوذة من "جداول بيانات Google" على بطاقة منفصلة لكل ورقة بيانات تسحب البيانات منها.
استخدام بطاقات متعددة
تتألف الإضافات عادةً من أكثر من بطاقة واحدة. يمكنك ضبط هذه
البطاقات كقائمة بسيطة لالتنقّل الأساسي باستخدام بطاقات متعددة،
أو ضبط طُرق تنقّل
أكثر تعقيدًا للتحكّم في كيفية تنقّل المستخدم بين البطاقات.
إذا كانت الإضافة تستخدِم تنقّلًا أساسيًا، عند فتح الإضافة لأول مرة، ينشئ تطبيق Google Workspace الذي تُضاف إليه الإضافة قائمة برؤوس البطاقات ويعرضها للمستخدم. يؤدي النقر على عنوان البطاقة إلى فتحها. يتوفّر أيضًا سهم للرجوع إلى قائمة عناوين البطاقة. لست بحاجة إلى ترميز وظائف العنوان وسهم الرجوع، ويتم ذلك تلقائيًا عند تحديد البطاقات في الإضافة.
تاريخ التعديل الأخير: 2025-02-16 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-02-16 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Workspace add-ons utilize cards, essentially UI pages, displayed in a sidebar or activity window, to present information and interactive elements."],["Each card is structured with a header, sections containing widgets (like buttons or text fields), and is designed around specific user tasks or data sets."],["Add-ons often employ multiple cards for navigation; basic navigation provides an automatic card header list and back arrow functionality."],["For optimal performance and user experience, it's recommended to keep the number of cards, sections, and widgets to a minimum, prioritizing simplicity in card design."],["Cards have technical limitations, restricting them to a maximum of 100 card sections and 100 widgets per section to maintain performance."]]],["Add-on cards, displayed in a sidebar or activity window, are UI pages built with `Card` objects. Cards have a header, optional subtitle/icon, and sections. Sections, separated by horizontal rules, contain UI widgets, and large sections collapse. Add-ons use multiple cards for navigation, presented as a list of headers. Basic navigation provides automatic back arrow functionality. Each card section can hold a maximum of 100 widgets, and a card can hold no more than 100 card sections.\n"]]
