Надстройка на основе карточек отображается в виде панели на боковой панели (или, на мобильном устройстве, в виде другого окна активности, доступного через меню). Надстройка имеет верхнюю панель инструментов, которая идентифицирует надстройку и отображает карточку — по сути, «страницу» пользовательского интерфейса надстройки. Apps Script представляет карточки в коде проекта с помощью объектов Card
.
Анатомия карты
Карточка — это группа элементов пользовательского интерфейса, которые вы проектируете. Карточка состоит из следующих разделов:
- Заголовок карты . Он идентифицирует карты. Он имеет текст заголовка и может иметь подзаголовок и значок.
Один или несколько разделов карты . Это подразделы области пользовательского интерфейса карты. Раздел может иметь заголовок текстового раздела. Разделы карты отделены друг от друга на карте горизонтальной линейкой. Если раздел карты особенно большой, он автоматически отображается как сворачиваемый раздел, который пользователи могут разворачивать или сворачивать по мере необходимости. Карта может иметь не более 100 разделов карты и должна иметь только несколько для лучшей производительности.
Каждый раздел карты содержит один или несколько виджетов пользовательского интерфейса . Виджеты предоставляют пользователю информацию или интерактивные элементы управления. Карточки и разделы карточек являются структурными виджетами, поэтому вы не можете добавлять их в раздел карточек. Раздел карточек может содержать не более 100 виджетов и должен быть максимально простым для лучшей производительности.
Вам следует разрабатывать карточки вокруг конкретных действий пользователя или наборов данных. Например, надстройка Google Workspace, которая отображает данные, взятые из Google Sheets, может иметь отдельную карточку для каждого листа, из которого она извлекает данные.
Использование нескольких карт
Дополнения обычно состоят из более чем одной карты. Вы можете либо настроить эти карты как простой список для базовой навигации с несколькими картами , либо настроить более сложные методы навигации для управления тем, как пользователь перемещается между картами.
Если надстройка использует базовую навигацию, то при первом открытии надстройки приложение Google Workspace, которое она расширяет, создает список заголовков карточек и представляет их пользователю. Нажатие на заголовок карточки открывает эту карточку. Также предусмотрена стрелка назад для возврата к списку заголовков карточек. Вам не нужно кодировать заголовок и функциональность стрелки назад — это делается автоматически при определении карточек в вашей надстройке.
При проектировании дополнений лучше ограничить количество карточек, которые вы показываете одновременно, поскольку карточки должны делить ограниченное количество экранного пространства. Также лучше избегать ненужной сложности в карточках .