Карты

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

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

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

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

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

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

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

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

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

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

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

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