Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Dodatek oparty na kartach wyświetla się jako panel na pasku bocznym (lub na urządzeniach mobilnych jako kolejne okno aktywności dostępne w menu). Dodatek ma górny pasek narzędzi, który identyfikuje dodatek i wyświetla kartę, czyli „stronę” interfejsu dodatku. Apps Script reprezentuje karty w kodzie projektu za pomocą obiektów Card.
Budowa karty
Karta to grupa zaprojektowanych przez Ciebie elementów interfejsu. Karta składa się z tych sekcji:
Nagłówek karty. Pozwala to zidentyfikować karty. Zawiera tekst tytułu i opcjonalnie podtytuł oraz ikonę.
Co najmniej 1 sekcja karty. Są to podziały obszaru interfejsu karty.
Sekcja może opcjonalnie zawierać nagłówek tekstowy.
Sekcje karty są oddzielone od siebie linią poziomą.
Jeśli sekcja karty jest szczególnie duża, jest automatycznie renderowana jako zwijana sekcja, którą użytkownicy mogą rozwijać i zwijać w zależności od potrzeb.
Karta może zawierać maksymalnie 100 sekcji, ale dla lepszej skuteczności powinna mieć ich tylko kilka.
Każda sekcja karty zawiera co najmniej 1 widżet interfejsu. Widżety dostarczają użytkownikowi informacji lub interaktywnych elementów sterujących. Karty i sekcje kart to widżety strukturalne, więc nie możesz ich dodawać do sekcji kart. Sekcja karty może zawierać maksymalnie 100 widżetów i powinna być jak najprostsza, aby zapewnić najlepszą wydajność.
Karty powinny być zaprojektowane pod kątem konkretnych działań użytkowników lub zbiorów danych. Na przykład dodatek do Google Workspace, który wyświetla dane pobrane z Arkuszy Google, może mieć osobną kartę dla każdego arkusza, z którego pobiera dane.
Korzystanie z wielu kart
Dodatki zwykle składają się z więcej niż 1 karty. Możesz skonfigurować te karty jako prostą listę do podstawowej nawigacji z wieloma kartami lub skonfigurować bardziej złożone metody nawigacji, aby kontrolować sposób przechodzenia użytkownika między kartami.
Jeśli dodatek korzysta z podstawowej nawigacji, po pierwszym otwarciu dodatku aplikacja Google Workspace, którą rozszerza, tworzy listę nagłówków kart i wyświetla ją użytkownikowi. Kliknięcie nagłówka karty spowoduje jej otwarcie. Dostępna jest też strzałka wstecz, która umożliwia powrót do listy nagłówków kart. Nie musisz programować funkcji nagłówka i strzałki wstecz – jest to robione automatycznie, gdy definiujesz karty w dodatku.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-04 UTC."],[[["\u003cp\u003eGoogle Workspace add-ons utilize cards, essentially UI pages, displayed in a sidebar or activity window, to present information and interactive elements.\u003c/p\u003e\n"],["\u003cp\u003eEach card is structured with a header, sections containing widgets (like buttons or text fields), and is designed around specific user tasks or data sets.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons often employ multiple cards for navigation; basic navigation provides an automatic card header list and back arrow functionality.\u003c/p\u003e\n"],["\u003cp\u003eFor 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.\u003c/p\u003e\n"],["\u003cp\u003eCards have technical limitations, restricting them to a maximum of 100 card sections and 100 widgets per section to maintain performance.\u003c/p\u003e\n"]]],["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"],null,[]]
