卡片

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

卡片剖析

插件卡片示例

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

  • 卡片标题。用于标识卡片。该标题包含标题文本,还可以选择显示字幕和图标。
  • 一个或多个卡片部分。这些卡片是卡片界面区域的细分。某个部分可以选择包含文本部分标题。 卡片上的各个版块通过水平规则相互分隔。 如果卡片部分特别大,系统会自动将其呈现为可折叠部分,用户可以根据需要展开或收起。一张卡片的卡片部分不得超过 100 个,为提高性能,应只使用几张卡片。

  • 每个卡片部分都包含一个或多个界面微件。微件为用户提供信息或交互式控件。卡片和卡片部分是结构性微件,因此您无法将其添加到卡片部分。卡片部分的微件数量不得超过 100 个,而且应尽可能简单以获得最佳性能。

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

使用多张银行卡

插件卡片示例

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

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

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