卡片

基于卡片的插件以窗格形式显示在边栏中(或者,在移动设备上,则显示为通过菜单访问的另一个 activity 窗口)。该插件具有一个顶部工具栏,用于标识该插件并显示一张卡片 - 实际上是插件界面的一个“页面”。Apps 脚本使用 Card 对象表示项目代码中的卡片。

卡片详解

插件卡片示例

卡片是您设计的一组界面元素。卡片包含以下部分:

  • 卡片标题。此字段用于标识卡。它具有标题文本,还可以选择包含副标题和图标。
  • 一个或多个卡片部分。它们是卡片界面区域的细分。章节还可以选择包含文本章节标题。 在卡片上,各个卡片部分通过水平线分隔。 如果卡片部分特别大,则会自动呈现为可折叠部分,用户可以根据需要展开或收起。一张卡片最多只能包含 100 个卡片部分,并且应仅设置几个部分以提高性能。

  • 每个卡片版块都包含一个或多个界面 widget。widget 可为用户提供信息或互动控件。卡片和卡片部分是结构性的 widget,因此您无法将其添加到卡片部分。一个卡片部分最多只能包含 100 个 widget,并且应尽可能简单以获得最佳性能。

您应围绕特定用户活动或数据集设计卡片。例如,显示从 Google 表格获取的数据的 Google Workspace 插件可能针对从中提取数据的每个工作表有单独的卡片。

使用多张卡

插件卡片示例

插件通常包含多张卡片。您可以将这些卡片配置为包含多个卡片的基本导航的简单列表,也可以配置更复杂的导航方法来控制用户在卡片之间移动的方式。

如果该插件使用基本导航,在首次打开 Google Workspace 应用时,该插件会扩展卡片标头列表,并将其呈现给用户。点击卡片标题即可打开该卡片。此外,它还提供一个返回箭头,用于返回卡片标题列表。您无需编写标题和返回箭头功能代码,当您在插件中定义卡片时,系统会自动完成此操作。

在设计插件时,最好限制一次显示的卡片数量,因为卡片必须共用有限的屏幕空间。此外,最好避免卡片中出现不必要的复杂性