Button

Tombol teks, ikon, atau teks dan ikon yang dapat diklik pengguna. Untuk contoh di aplikasi Google Chat, lihat Menambahkan tombol.

Untuk membuat gambar menjadi tombol yang dapat diklik, tentukan Image (bukan ImageComponent) dan tetapkan tindakan onClick.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
Kolom
text

string

Teks yang ditampilkan di dalam tombol.
icon

object (Icon)

Ikon yang ditampilkan di dalam tombol. Jika icon dan text ditetapkan, ikon akan muncul sebelum teks.
color

object (Color)

Opsional. Warna tombol. Jika ditetapkan, type tombol akan ditetapkan ke FILLED dan warna kolom text dan icon akan ditetapkan ke warna yang kontras agar mudah dibaca. Misalnya, jika warna tombol ditetapkan ke biru, teks atau ikon apa pun di tombol akan ditetapkan ke putih.

Untuk menetapkan warna tombol, tentukan nilai untuk kolom red, green, dan blue. Nilainya harus berupa angka float antara 0 dan 1 berdasarkan nilai warna RGB, dengan 0 (0/255) mewakili ketiadaan warna dan 1 (255/255) mewakili intensitas maksimum warna.

Misalnya, kode berikut menetapkan warna menjadi merah pada intensitas maksimumnya:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

Kolom alpha tidak tersedia untuk warna tombol. Jika ditentukan, kolom ini akan diabaikan.
onClick

object (OnClick)

Wajib. Tindakan yang akan dilakukan saat pengguna mengklik tombol, seperti membuka hyperlink atau menjalankan fungsi kustom.
disabled

boolean

Jika true, tombol akan ditampilkan dalam status tidak aktif dan tidak merespons tindakan pengguna.
altText

string

Teks alternatif yang digunakan untuk aksesibilitas.

Tetapkan teks deskriptif yang memberi tahu pengguna fungsi tombol tersebut. Misalnya, jika tombol membuka hyperlink, Anda dapat menulis: "Membuka tab browser baru dan membuka dokumentasi developer Google Chat di https://developers.google.com/workspace/chat".
type

enum (Type)

Opsional. Jenis tombol. Jika tidak disetel, jenis tombol akan ditetapkan secara default ke OUTLINED. Jika kolom color ditetapkan, jenis tombol akan dipaksa menjadi FILLED dan nilai apa pun yang ditetapkan untuk kolom ini akan diabaikan.

Jenis

Opsional. type tombol. Jika kolom color ditetapkan, type akan dipaksa ke FILLED.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Enum
TYPE_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
OUTLINED Tombol dengan garis batas adalah tombol penekanan sedang. Tombol ini biasanya berisi tindakan yang penting, tetapi bukan tindakan utama di aplikasi Chat atau add-on.
FILLED Tombol terisi memiliki penampung dengan warna solid. Tombol ini memiliki dampak visual paling besar dan direkomendasikan untuk tindakan penting dan utama di aplikasi Chat atau add-on.
FILLED_TONAL Tombol tonal terisi adalah jalan tengah alternatif antara tombol terisi dan tombol bergaris batas. Tombol ini berguna dalam konteks saat tombol prioritas lebih rendah memerlukan sedikit lebih banyak penekanan daripada yang diberikan tombol garis batas.
BORDERLESS Tombol tidak memiliki penampung yang tidak terlihat dalam status defaultnya. Tombol ini sering digunakan untuk tindakan dengan prioritas terendah, terutama saat menampilkan beberapa opsi.