Class Columns

欄

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

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

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

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

適用於 Google Chat 應用程式和 Google Workspace 外掛程式。支援資料欄的外掛程式 UI 包括：

  • 使用者從電子郵件草稿開啟外掛程式時顯示的對話方塊。
  • 使用者在 Google 日曆活動中透過「Add attachment」選單開啟外掛程式時，會顯示的對話方塊。
    // 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在「資料欄」小工具中新增 Column。
setWrapStyle(wrapStyle)Columns設定欄的包裝樣式，控制欄的大小如何根據螢幕寬度調整。

內容詳盡的說明文件

addColumn(column)

將 Column 新增至「資料欄」小工具。系統會按照新增的順序顯示資料欄。最多可新增兩個資料欄。

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

參數

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

回攻員

Columns：這個物件用於鏈結。

setWrapStyle(wrapStyle)

設定欄的包覆樣式，控制欄的大小如何根據螢幕寬度調整。

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

參數

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

回攻員

Columns：這個物件用於鏈結。