Class Columns

Kolom

Widget Columns menampilkan hingga 2 kolom dalam kartu atau dialog. Anda dapat menambahkan widget ke setiap Column; widget akan muncul dalam urutan yang ditentukan. Untuk contoh di aplikasi Google Chat, lihat Kolom.

Tinggi setiap kolom ditentukan oleh kolom yang lebih tinggi. Misalnya, jika kolom pertama lebih tinggi daripada kolom kedua, kedua kolom akan memiliki tinggi kolom pertama. Karena setiap kolom dapat berisi jumlah widget yang berbeda, Anda tidak dapat menentukan baris atau menyelaraskan widget di antara kolom.

Kolom ditampilkan berdampingan. Anda dapat menyesuaikan lebar setiap kolom menggunakan kolom HorizontalSizeStyle. Jika lebar layar pengguna terlalu sempit, kolom kedua akan berada di bawah kolom pertama:

  • Di web, kolom kedua akan di-wrap jika lebar layar kurang dari atau sama dengan 480 piksel.
  • Di perangkat iOS, kolom kedua akan di-wrap jika lebar layar kurang dari atau sama dengan 300 pt.
  • Di perangkat Android, kolom kedua akan di-wrap jika lebar layar kurang dari atau sama dengan 320 dp.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace. UI add-on yang mendukung kolom meliputi:

  • Dialog yang ditampilkan saat pengguna membuka add-on dari draf email.
  • Dialog yang ditampilkan saat pengguna membuka add-on dari menu Tambahkan lampiran di acara Google Kalender. 
    // 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);

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addColumn(column)ColumnsMenambahkan Column ke widget Kolom.
addEventAction(eventAction)WidgetMenambahkan tindakan peristiwa yang dapat dilakukan pada widget.
setId(id)WidgetMenetapkan ID unik yang ditetapkan yang digunakan untuk mengidentifikasi widget yang akan diubah.
setVisibility(visibility)WidgetMenetapkan visibilitas widget.
setWrapStyle(wrapStyle)ColumnsMenetapkan gaya pembungkusan kolom, mengontrol cara pengubahan ukuran kolom berdasarkan lebar layar.

Dokumentasi mendetail

addColumn(column)

Menambahkan Column ke widget Kolom. Kolom ditampilkan sesuai urutan penambahannya. Anda dapat menambahkan hingga dua kolom. 

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

Parameter

NamaJenisDeskripsi
columnColumnKolom turunan yang akan ditambahkan ke widget Kolom.

Pulang pergi

Columns — Objek ini, untuk pengaitan.

addEventAction(eventAction)

Menambahkan tindakan peristiwa yang dapat dilakukan pada widget.

Parameter

NamaJenisDeskripsi
eventActionEventActionEventAction yang akan ditambahkan.

Pulang pergi

Widget — Objek, untuk pengaitan.

setId(id)

Menetapkan ID unik yang ditetapkan yang digunakan untuk mengidentifikasi widget yang akan diubah. Mutasi widget hanya didukung di Add-On.

Parameter

NamaJenisDeskripsi
idStringID widget, dengan batas 64 karakter dan dalam format `[a-zA-Z0-9-]+`.

Pulang pergi

Widget — Objek ini, untuk pengaitan.

setVisibility(visibility)

Menetapkan visibilitas widget. Nilai defaultnya adalah `VISIBLE`.

Parameter

NamaJenisDeskripsi
visibilityVisibilityVisibility widget.

Pulang pergi

Widget — Objek, untuk pengaitan.

setWrapStyle(wrapStyle)

Menetapkan gaya pembungkusan kolom, mengontrol cara pengubahan ukuran kolom berdasarkan lebar layar. 

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

Parameter

NamaJenisDeskripsi
wrapStyleWrapStyleGaya pelengkapan yang akan ditetapkan untuk kolom.

Pulang pergi

Columns — Objek ini, untuk pengaitan.