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