A card-based Google Workspace add-on appears as a pane in the sidebar (or, on mobile, as another activity window reached through the menu). The add-on has a top toolbar that identifies the add-on and displays a card —essentially a "page" of the add-on's UI. Google Apps Script represents cards in project code using Card objects.
آناتومی کارت
یک کارت گروهی از عناصر رابط کاربری است که شما طراحی میکنید. یک کارت از بخشهای زیر تشکیل شده است:
- سربرگ کارت . این سربرگ کارتها را مشخص میکند. دارای متن عنوان است و میتواند به صورت اختیاری دارای زیرنویس و آیکون نیز باشد.
یک یا چند بخش کارت . اینها زیرمجموعههای ناحیه رابط کاربری کارت هستند. یک بخش میتواند دارای یک سربرگ بخش متنی باشد. بخشهای کارت با یک خط افقی روی کارت از یکدیگر جدا میشوند. اگر یک بخش کارت به طور خاص بزرگ باشد، به طور خودکار به عنوان یک بخش قابل جمع شدن ارائه میشود که کاربران میتوانند در صورت نیاز آن را گسترش یا جمع کنند. یک کارت نمیتواند بیش از ۱۰۰ بخش کارت داشته باشد و برای عملکرد بهتر باید فقط تعداد کمی داشته باشد.
Each card section contains one or more UI widgets . Widgets provide the user with information or interactive controls. Cards and card sections are structural widgets, so you cannot add those to a card section. A card section can have no more than 100 widgets , and should be as concise as possible for best performance.
شما باید کارتهایی را حول فعالیتهای خاص کاربر یا مجموعه دادههای خاص طراحی کنید. برای مثال، یک افزونه Google Workspace که دادههای گرفته شده از Google Sheets را نمایش میدهد، ممکن است برای هر برگهای که دادهها را از آن دریافت میکند، کارت جداگانهای داشته باشد.
استفاده از چندین کارت
افزونهها معمولاً از بیش از یک کارت تشکیل شدهاند. میتوانید این کارتها را به عنوان یک لیست برای پیمایش اولیه پیکربندی کنید یا روشهای پیمایش پیچیدهتری را برای کنترل نحوه حرکت کاربر بین کارتها پیکربندی کنید. برای جزئیات بیشتر، به پیمایش اولیه با چندین کارت مراجعه کنید.
اگر افزونه از ناوبری ساده استفاده کند، وقتی افزونه برای اولین بار باز میشود، برنامه Google Workspace فهرستی از سربرگهای کارت را ایجاد کرده و به کاربر ارائه میدهد. کلیک روی سربرگ کارت، آن کارت را باز میکند. یک فلش برگشت نیز برای بازگشت به لیست سربرگ کارت ارائه شده است. لازم نیست عملکرد سربرگ و فلش برگشت را کدنویسی کنید - این کار به طور خودکار هنگام تعریف کارتها در افزونه شما انجام میشود.
هنگام طراحی افزونهها، بهتر است تعداد کارتهایی که به طور همزمان نمایش میدهید را محدود کنید ، زیرا کارتها باید فضای محدودی از صفحه نمایش را به اشتراک بگذارند. همچنین بهتر است از پیچیدگیهای غیرضروری در کارتها خودداری کنید .
به دلایل عملکردی، نمیتوانید بیش از ۱۰۰ ویجت یا ۱۰۰ بخش کارت به یک کارت اضافه کنید.