卡片

資訊卡型外掛程式會以窗格的形式顯示在側欄中 (在行動裝置上,在行動裝置上則透過選單前往另一個活動視窗)。外掛程式有一個頂端工具列,可用來識別外掛程式並顯示資訊卡,基本上就是外掛程式 UI 的「頁面」。Apps Script 使用 Card 物件,代表專案程式碼中的卡片。

卡片解析

外掛程式資訊卡範例

資訊卡是您設計的一組 UI 元素。資訊卡由以下部分組成:

  • 資訊卡標題。這代表卡片。其中包含標題文字,可以視需要加上副標題和圖示。
  • 一或多個資訊卡區塊:這些是資訊卡 UI 區域的子產品群組。區段也可以選擇設定文字區段標題。資訊卡區段會按照水平規則在資訊卡中彼此區隔。如果資訊卡區段特別大,則會自動轉譯成可收合的區段,使用者可以視需要展開或收合。一張資訊卡最多只能有 100 個資訊卡區段,而且只能有少數幾個區塊,以提升效能。

  • 每個資訊卡區段都包含一或多個 UI 小工具。小工具可以為使用者提供資訊或互動式控制項。資訊卡和資訊卡區段屬於結構小工具,因此無法新增至資訊卡區段。資訊卡區段最多只能有 100 個小工具,而且必須盡可能精簡以獲得最佳效能。

您應以特定使用者活動或資料集來設計資訊卡。舉例來說,顯示從 Google 試算表擷取資料的 Google Workspace 外掛程式,可能會為每個提取資料的工作表提供單獨的資訊卡。

使用多張資訊卡

外掛程式資訊卡範例

外掛程式通常包含多張資訊卡。您可以將這些資訊卡設為使用多張資訊卡的基本導覽的簡易清單,也可以設定更複雜的導覽方法,控制使用者在資訊卡之間移動的方式。

如果外掛程式使用基本導覽,則外掛程式首次開啟 Google Workspace 應用程式時,會擴充卡片標頭清單並向使用者顯示。按一下資訊卡標題即可開啟該資訊卡。還提供返回箭頭,讓您返回卡片標頭清單。您不需要編寫標頭和返回箭頭功能的程式碼,系統會在外掛程式中定義資訊卡時自動完成這項作業。

設計外掛程式時,建議您一次限制顯示資訊卡數量,因為資訊卡的螢幕空間有限。此外,建議您避免在資訊卡中使用不必要的複雜性