卡片

基于卡片的插件在边栏中显示为窗格(在移动设备上,显示为通过菜单到达的另一个活动窗口)。该插件有一个顶部工具栏,可用于标识插件并显示卡片 - 基本上是插件界面的“页面”。Apps 脚本使用 Card 对象在项目代码中表示卡片。

卡片剖析

附加卡示例

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

  • 卡片标题。用于标识卡片。该标题包含标题文字,并且可以有副标题和图标。
  • 一个或多个卡片部分。这些是卡片界面区域的细分。某个部分可能包含文字部分标题。 卡片上各部分通过水平规则分隔。如果卡片部分特别大,系统会自动将其呈现为可收起的部分,用户可以根据需要展开或收起。为提高性能,一个卡片最多只能包含 100 个卡片部分,并且应该只包含几个。

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

您应围绕具体的用户活动或数据集设计卡片。例如,如果 Google Workspace 插件显示从 Google 表格获取的数据,它可能会从中提取数据的每张工作表有单独的卡片。

使用多张卡

附加卡示例

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

如果插件使用基本导航,那么当插件首次打开 Google Workspace 应用时,它会扩展一个卡片标题列表,并向用户显示该列表。点击卡片标题会打开该卡片。此外,系统还提供了返回箭头以返回卡片标题列表。您无需对标头和返回箭头功能进行编码 - 当您在插件中定义卡片时,系统会自动完成此操作。

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