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