卡片

基于卡片的插件会显示为边栏中的窗格（在移动设备上，则会显示为通过菜单访问的另一个 activity 窗口）。该插件有一个顶部工具栏，用于标识插件并显示卡片，这实际上是插件界面的“页面”。Apps Script 使用 Card 对象在项目代码中表示卡片。

卡片解剖

卡片是指您设计的一组界面元素。卡片由以下部分组成：

• 卡片标题。这用于标识卡片。它包含标题文本，并且可以选择性地包含副标题和图标。

• 一个或多个卡片部分。这些是卡片界面区域的细分区域。部分可以选择添加文本部分标题。卡片中的各个部分之间会用水平线分隔开来。如果卡片部分特别大，系统会自动将其呈现为可收起的部分，以便用户根据需要展开或收起。一张卡片最多只能包含 100 个卡片部分，并且最好只包含几个卡片部分，以便提升效果。

• 每个卡片部分包含一个或多个界面widget。微件可向用户提供信息或互动控件。卡片和卡片版块是结构 widget，因此您无法将它们添加到卡片版块。卡片版块可以包含的 widget 数量不得超过 100 个，并且应尽可能简单，以便获得最佳效果。

您应围绕特定用户活动或数据集来设计卡片。例如，显示从 Google 表格中提取的数据的 Google Workspace 插件可能会为其提取数据的每个表格提供单独的卡片。

使用多张卡片

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

如果该插件使用基本导航功能，那么在首次打开该插件时，它扩展的 Google Workspace 应用会构建卡片标题列表并将其呈现给用户。点击卡片标题即可打开该卡片。系统还提供了返回箭头，以便返回到卡片标题列表。您无需编写标题和返回箭头功能的代码，因为在您在插件中定义卡片时，系统会自动执行此操作。

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

注意 ：出于性能原因，您不能向一张卡片添加超过 100 个 widget 或 100 个卡片部分。