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