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