Class Columns

欄

Columns 小工具最多可在資訊卡或對話方塊中顯示 2 欄。你可以為每個 Column 新增小工具，小工具會按照指定順序顯示。如需 Google Chat 應用程式的範例，請參閱「Columns」。

每個資料欄的高度取決於較高的資料欄。舉例來說，如果第一欄高於第二欄，兩欄的高度都會與第一欄相同。由於每個資料欄可包含不同數量的小工具，因此您無法定義資料列，也無法對齊資料欄之間的小工具。

資料欄會並排顯示。您可以使用 HorizontalSizeStyle 欄位自訂每個資料欄的寬度。如果使用者螢幕寬度太窄，第二欄會換行到第一欄下方：

  • 在網頁上，如果畫面寬度小於或等於 480 像素，第二欄就會換行。
  • 在 iOS 裝置上，如果畫面寬度小於或等於 300 pt，第二欄就會換行。
  • 在 Android 裝置上，如果螢幕寬度小於或等於 320 dp，第二欄就會換行。

適用於 Google Chat 擴充應用程式和 Google Workspace 外掛程式。支援資料欄的附加元件 UI 包括：

  • 使用者從電子郵件草稿開啟外掛程式時顯示的對話方塊。
  • 使用者透過 Google 日曆活動的「新增附件」選單開啟外掛程式時，系統顯示的對話方塊。 
    // Build a column that is aligned in the center and fills the space:
const column =
    CardService.newColumn()
        .setHorizontalSizeStyle(
            CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
        .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
        .setVerticalAlignment(CardService.VerticalAlignment.CENTER);
const columns = CardService.newColumns().addColumn(column).setWrapStyle(
    CardService.WrapStyle.WRAP);

方法

方法傳回類型簡短說明
addColumn(column)Columns在「Columns」小工具中新增 Column。
addEventAction(eventAction)Widget新增可在小工具上執行的事件動作。
setId(id)Widget設定指派的專屬 ID，用於識別要變動的小工具。
setVisibility(visibility)Widget設定小工具的顯示設定。
setWrapStyle(wrapStyle)Columns設定欄的換行樣式，控制欄如何根據螢幕寬度調整大小。

內容詳盡的說明文件

addColumn(column)

在「Columns」小工具中新增 Column。系統會按照加入資料欄的順序顯示資料欄。最多可以新增兩欄。 

const columns = CardService.newColumns().addColumn(CardService.newColumn());

參數

名稱類型說明
columnColumn要新增至「資料欄」小工具的子項資料欄。

回攻員

Columns - 這個物件，用於鏈結。

addEventAction(eventAction)

新增可在小工具上執行的事件動作。

參數

名稱類型說明
eventActionEventAction要新增的 EventAction。

回攻員

Widget - 鏈結用的物件。

setId(id)

設定指派的專屬 ID，用於識別要變動的小工具。外掛程式僅支援小工具突變。

參數

名稱類型說明
idString小工具的 ID，最多 64 個字元，格式為 `[a-zA-Z0-9-]+`。

回攻員

Widget - 這個物件，用於鏈結。

setVisibility(visibility)

設定小工具的顯示設定。預設值為 `VISIBLE`。

參數

名稱類型說明
visibilityVisibility小工具的 Visibility。

回攻員

Widget - 鏈結用的物件。

setWrapStyle(wrapStyle)

設定欄的換行樣式，控制欄如何根據畫面寬度調整大小。 

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

參數

名稱類型說明
wrapStyleWrapStyle要為資料欄設定的換行樣式。

回攻員

Columns - 這個物件，用於鏈結。