کارت ها

یک برافزای مبتنی بر کارت به‌عنوان یک صفحه در نوار کناری ظاهر می‌شود (یا در تلفن همراه، به‌عنوان پنجره فعالیت دیگری که از طریق منو قابل دسترسی است). این افزونه دارای یک نوار ابزار بالایی است که افزونه را شناسایی می کند و یک کارت را نمایش می دهد - که اساساً یک "صفحه" از رابط کاربری افزونه است. Apps Script کارت ها را در کد پروژه با استفاده از اشیاء Card نشان می دهد.

آناتومی کارت

کارت گروهی از عناصر رابط کاربری است که شما طراحی می کنید. یک کارت از بخش های زیر تشکیل شده است:

• یک هدر کارت این کارت ها را شناسایی می کند. دارای متن عنوان است و ممکن است به صورت اختیاری یک زیرنویس و یک نماد داشته باشد.

• یک یا چند بخش کارت . اینها زیرمجموعه های ناحیه رابط کاربری کارت هستند. یک بخش ممکن است به صورت اختیاری دارای سرصفحه بخش متن باشد. بخش های کارت بر روی کارت توسط یک قانون افقی از یکدیگر جدا می شوند. اگر یک بخش کارت به خصوص بزرگ باشد، به طور خودکار به عنوان یک بخش جمع شونده ارائه می شود که کاربران می توانند در صورت نیاز آن را بزرگ یا جمع کنند. یک کارت نمی تواند بیش از 100 بخش کارت داشته باشد و برای عملکرد بهتر باید فقط تعداد کمی داشته باشد.

• هر بخش کارت حاوی یک یا چند ویجت رابط کاربری است . ویجت ها اطلاعات یا کنترل های تعاملی را در اختیار کاربر قرار می دهند. کارت‌ها و بخش‌های کارت، ویجت‌های ساختاری هستند، بنابراین نمی‌توانید آن‌ها را به بخش کارت اضافه کنید. یک بخش کارت نمی تواند بیش از 100 ویجت داشته باشد و برای بهترین عملکرد باید تا حد امکان ساده باشد.

شما باید کارت هایی را پیرامون فعالیت های کاربر خاص یا مجموعه داده ها طراحی کنید. برای مثال، افزونه Google Workspace که داده‌های گرفته شده از Google Sheets را نمایش می‌دهد، ممکن است برای هر برگه‌ای که داده‌ها را از آن می‌کشد، کارت جداگانه‌ای داشته باشد.

استفاده از چند کارت

افزونه ها معمولاً از بیش از یک کارت تشکیل شده اند. می‌توانید این کارت‌ها را به‌عنوان یک فهرست ساده برای پیمایش اولیه با چند کارت پیکربندی کنید، یا روش‌های پیمایش پیچیده‌تری را برای کنترل نحوه حرکت کاربر بین کارت‌ها پیکربندی کنید.

اگر افزونه از پیمایش اولیه استفاده می‌کند، هنگامی که برافزا برای اولین بار باز می‌شود، برنامه Google Workspace، فهرستی از سرصفحه‌های کارت را ایجاد می‌کند و آن‌ها را به کاربر ارائه می‌دهد. با کلیک بر روی هدر کارت آن کارت باز می شود. یک فلش عقب نیز برای بازگشت به لیست سرصفحه کارت ارائه شده است. لازم نیست عملکرد هدر و پیکان عقب را کدنویسی کنید—این به طور خودکار زمانی که کارت ها را در افزونه خود تعریف می کنید انجام می شود.

هنگام طراحی افزونه‌ها، بهتر است تعداد کارت‌هایی را که به‌طور هم‌زمان نمایش می‌دهید محدود کنید ، زیرا کارت‌ها باید مقدار محدودی از فضای صفحه نمایش را به اشتراک بگذارند. همچنین بهتر است از پیچیدگی های غیر ضروری در کارت ها جلوگیری کنید .