Button

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge düğmesi. Google Chat uygulamalarındaki bir örnek için Düğme ekleme başlıklı makaleyi inceleyin.

Bir resmi tıklanabilir düğme haline getirmek için Image (ImageComponent değil) belirtin ve bir onClick işlemi ayarlayın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

JSON gösterimi
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
Alanlar
text

string

Düğmenin içinde gösterilen metin.

icon

object (Icon)

Düğmenin içinde gösterilen simge. Hem icon hem de text ayarlanırsa simge metinden önce görünür.

color

object (Color)

İsteğe bağlı. Düğmenin rengi. Ayarlanırsa düğme type, FILLED olarak ayarlanır ve text ile icon alanlarının rengi, okunabilirlik için kontrast bir renge ayarlanır. Örneğin, düğme rengi mavi olarak ayarlanırsa düğmedeki tüm metinler veya simgeler beyaz olarak ayarlanır.

Düğme rengini ayarlamak için red, green ve blue alanlarına bir değer girin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan sayı olmalıdır. Burada 0 (0/255) rengin olmadığını, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıdaki kod rengi maksimum yoğunlukta kırmızıya ayarlar:

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

Düğme rengi için alpha alanı kullanılamıyor. Belirtilirse bu alan yoksayılır.

onClick

object (OnClick)

Zorunlu. Kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel işlev çalıştırma).

disabled

boolean

true ise düğme etkin olmayan bir durumda gösterilir ve kullanıcı işlemlerine yanıt vermez.

altText

string

Erişilebilirlik için kullanılan alternatif metin.

Kullanıcılara düğmenin ne işe yaradığını bildiren açıklayıcı bir metin ayarlayın. Örneğin, bir düğme köprü açıyorsa şöyle yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici belgelerine gider.

type

enum (Type)

İsteğe bağlı. Düğmenin türü. Ayarlanmazsa düğme türü varsayılan olarak OUTLINED olur. color alanı ayarlanırsa düğme türü FILLED olarak zorlanır ve bu alan için ayarlanan tüm değerler yoksayılır.

Tür

İsteğe bağlı. Düğmenin türü. color alanı ayarlanırsa type, FILLED olarak zorunlu kılınır.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.

Sıralamalar
TYPE_UNSPECIFIED Kullanmayın. Belirtilmedi.
OUTLINED Ana hatlı düğmeler, orta düzeyde vurgu yapılan düğmelerdir. Genellikle önemli olan ancak Chat uygulamasındaki veya eklentideki birincil işlem olmayan işlemleri içerirler.
FILLED Dolu düğmelerde düz renkli bir kapsayıcı bulunur. En fazla görsel etkiye sahip olan bu düğme, Chat uygulaması veya eklentideki önemli ve birincil işlemler için önerilir.
FILLED_TONAL Dolgulu ton düğmesi, dolgulu ve ana hatlı düğmeler arasında alternatif bir orta noktadır. Daha düşük öncelikli bir düğmenin, ana hatlı bir düğmenin vereceğinden biraz daha fazla vurgu gerektirdiği bağlamlarda kullanışlıdır.
BORDERLESS Düğmelerin varsayılan durumunda görünmez bir kapsayıcı yoktur. Genellikle en düşük öncelikli işlemler için, özellikle de birden fazla seçenek sunulurken kullanılır.