卡片

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

卡片结构

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

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

• 一个或多个卡片部分。这些是卡片界面区域的细分部分。一个部分可以选择性地包含一个文本部分标题。 卡片上的各个卡片部分之间用水平线分隔。 如果卡片部分特别大，系统会自动将其呈现为可折叠的部分，用户可以根据需要展开或折叠该部分。 一张卡片最多可以包含 100 个卡片部分，但为了获得更好的效果，最好只包含几个卡片部分。

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

您应围绕特定用户活动或数据集设计卡片。例如，如果某个 Google Workspace 加载项显示从 Google 表格中提取的数据，那么它可能会为从中提取数据的每个工作表分别显示一张卡片。

使用多张卡片

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

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

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

注意： 出于性能考虑，您无法向卡片添加超过 100 个 widget 或 100 个卡片部分。