Class Columns

Cột

Tiện ích Columns hiển thị tối đa 2 cột trong thẻ hoặc hộp thoại. Bạn có thể thêm các tiện ích vào từng Column; các tiện ích sẽ xuất hiện theo thứ tự mà bạn chỉ định. Để xem ví dụ về các ứng dụng Google Chat, hãy xem Cột.

Chiều cao của mỗi cột được xác định bằng cột cao hơn. Ví dụ: nếu cột đầu tiên cao hơn cột thứ hai, thì cả hai cột đều có chiều cao bằng cột đầu tiên. Vì mỗi cột có thể chứa một số lượng tiện ích khác nhau, nên bạn không thể xác định hàng hoặc căn chỉnh tiện ích giữa các cột.

Các cột được hiển thị cạnh nhau. Bạn có thể tuỳ chỉnh chiều rộng của từng cột bằng trường HorizontalSizeStyle. Nếu chiều rộng màn hình của người dùng quá hẹp, cột thứ hai sẽ xuống dòng bên dưới cột thứ nhất:

  • Trên web, cột thứ hai sẽ xuống dòng nếu chiều rộng màn hình nhỏ hơn hoặc bằng 480 pixel.
  • Trên thiết bị iOS, cột thứ hai sẽ xuống dòng nếu chiều rộng màn hình nhỏ hơn hoặc bằng 300 pt.
  • Trên thiết bị Android, cột thứ hai sẽ xuống dòng nếu chiều rộng màn hình nhỏ hơn hoặc bằng 320 dp.

Dành cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace. Sau đây là giao diện người dùng của tiện ích bổ sung hỗ trợ các cột:

  • Hộp thoại xuất hiện khi người dùng mở tiện ích bổ sung từ một email nháp.
  • Hộp thoại xuất hiện khi người dùng mở tiện ích bổ sung từ trình đơn Thêm tệp đính kèm trong một sự kiện trên Lịch 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);

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addColumn(column)ColumnsThêm một Column vào tiện ích Cột.
addEventAction(eventAction)WidgetThêm thao tác sự kiện có thể thực hiện trên tiện ích.
setId(id)WidgetĐặt mã nhận dạng duy nhất được chỉ định dùng để xác định tiện ích cần thay đổi.
setVisibility(visibility)WidgetĐặt chế độ hiển thị của tiện ích.
setWrapStyle(wrapStyle)ColumnsĐặt kiểu xuống dòng của các cột, kiểm soát cách cột đổi kích thước dựa trên chiều rộng màn hình.

Tài liệu chi tiết

addColumn(column)

Thêm một Column vào tiện ích Cột. Các cột sẽ xuất hiện theo thứ tự được thêm vào. Bạn có thể thêm tối đa 2 cột. 

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

Thông số

TênLoạiMô tả
columnColumnMột cột con để thêm vào tiện ích Cột.

Cầu thủ trả bóng

Columns – Đối tượng này, để liên kết.

addEventAction(eventAction)

Thêm thao tác sự kiện có thể thực hiện trên tiện ích.

Thông số

TênLoạiMô tả
eventActionEventActionEventAction cần thêm.

Cầu thủ trả bóng

Widget – Đối tượng, để liên kết.

setId(id)

Đặt mã nhận dạng duy nhất được chỉ định dùng để xác định tiện ích cần thay đổi. Chỉ có Tiện ích bổ sung mới hỗ trợ thao tác thay đổi tiện ích.

Thông số

TênLoạiMô tả
idStringMã nhận dạng của tiện ích, có giới hạn 64 ký tự và ở định dạng `[a-zA-Z0-9-]+`.

Cầu thủ trả bóng

Widget – Đối tượng này, để liên kết.

setVisibility(visibility)

Đặt chế độ hiển thị của tiện ích. Giá trị mặc định là "VISIBLE".

Thông số

TênLoạiMô tả
visibilityVisibilityVisibility của tiện ích.

Cầu thủ trả bóng

Widget – Đối tượng, để liên kết.

setWrapStyle(wrapStyle)

Đặt kiểu xuống dòng của các cột, kiểm soát cách cột đổi kích thước dựa trên chiều rộng màn hình. 

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

Thông số

TênLoạiMô tả
wrapStyleWrapStyleKiểu xuống dòng cần đặt cho các cột.

Cầu thủ trả bóng

Columns – Đối tượng này, để liên kết.