卡片

基于卡片的 Google Workspace 插件在边栏中显示为窗格（或在移动设备上，通过菜单访问另一个活动窗口）。该插件有一个顶部工具栏，用于标识该插件并显示卡片，本质上是插件界面的"页面"。Google Apps 脚本使用 Card 对象在项目代码中表示 卡片。

卡片结构

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

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

• 一个或多个卡片部分 。这些是卡片界面区域的细分。 部分可以包含文本部分标题。卡片部分之间通过水平规则在卡片上分隔开。如果卡片部分特别大，系统会自动将其呈现为可折叠的部分，用户可以根据需要展开或收起该部分。一张卡片最多可以包含 100 个卡片部分， 并且为了获得更好的性能，应仅包含少量卡片部分。

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

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

使用多张卡片

加载项通常包含多张卡片。您可以将这些卡片配置为列表以进行基本导航，也可以配置更复杂 的导航方法 来控制用户在卡片之间移动的方式。如需了解详情，请参阅 使用多张卡片进行基本导航。

如果加载项使用基本导航，则当首次打开加载项时，它所扩展的 Google Workspace 应用会构建卡片标题列表并将其呈现给用户。点击卡片标题会打开该卡片。系统还会提供一个返回箭头，以便返回到卡片标题列表。您无需对标题和返回箭头功能进行编码，因为在加载项中定义卡片时，系统会自动执行此操作。

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

出于性能方面的考虑，您无法向一张卡片添加超过 100 个小部件或 100 个卡片部分。