Карты

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Надстройка на основе карты отображается в виде панели на боковой панели (или, на мобильном устройстве, в виде другого окна активности, доступного через меню). Надстройка имеет верхнюю панель инструментов, которая идентифицирует надстройку и отображает карточку — по сути, «страницу» пользовательского интерфейса надстройки. Apps Script представляет карточки в коде проекта с помощью объектов Card .

Анатомия карты

Пример дополнительной карты

Карточка — это группа элементов пользовательского интерфейса, которые вы разрабатываете. Карта состоит из следующих разделов:

  • Заголовок карты . Это идентифицирует карты. Он имеет текст заголовка и может дополнительно иметь подзаголовок и значок.
  • Один или несколько разделов карты . Это подразделения области пользовательского интерфейса карты. Раздел может дополнительно иметь заголовок текстового раздела. Секции карты отделены друг от друга на карте горизонтальной линейкой. Если раздел карточки особенно велик, он автоматически отображается как сворачиваемый раздел, который пользователи могут разворачивать или сворачивать по мере необходимости. Карта может иметь не более 100 разделов карты , а для лучшей производительности их должно быть только несколько.

  • Каждый раздел карточки содержит один или несколько виджетов пользовательского интерфейса . Виджеты предоставляют пользователю информацию или интерактивные элементы управления. Карточки и разделы карточек являются структурными виджетами, поэтому вы не можете добавлять их в раздел карточек. Раздел карточки может содержать не более 100 виджетов и должен быть максимально простым для обеспечения максимальной производительности.

Вы должны создавать карты вокруг конкретных действий пользователя или наборов данных. Например, надстройка Google Workspace, которая отображает данные, взятые из Google Таблиц, может иметь отдельную карточку для каждого листа, из которого она извлекает данные.

Использование нескольких карт

Пример дополнительной карты

Дополнения обычно состоят из более чем одной карты. Вы можете настроить эти карточки как простой список для базовой навигации с несколькими карточками или настроить более сложные методы навигации, чтобы контролировать, как пользователь перемещается между карточками.

Если надстройка использует базовую навигацию, при первом открытии надстройки приложение Google Workspace расширяет список заголовков карточек и представляет их пользователю. При нажатии на заголовок карты открывается эта карта. Также предусмотрена стрелка назад, чтобы вернуться к списку заголовков карточек. Вам не нужно кодировать функции заголовка и стрелки назад — это делается автоматически, когда вы определяете карточки в своем дополнении.

При разработке надстроек лучше ограничить количество одновременно отображаемых карточек, поскольку карточки должны занимать ограниченное пространство на экране. Также лучше избегать ненужной сложности в карточках .