Button

Przycisk z tekstem, ikoną lub tekstem i ikoną, który użytkownicy mogą kliknąć. Przykład dotyczący aplikacji Google Chat znajdziesz w sekcji Dodawanie przycisku.

Aby obraz stał się klikalnym przyciskiem, określ Image (nie ImageComponent) i ustaw działanie onClick.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.

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

string

Tekst wyświetlany na przycisku.
icon

object (Icon)

Ikona wyświetlana na przycisku. Jeśli ustawione są zarówno icon, jak i text, ikona pojawia się przed tekstem.
color

object (Color)

Opcjonalnie. Kolor przycisku. Jeśli ta opcja jest ustawiona, przycisk type jest ustawiony na FILLED, a pola text i icon mają kontrastujący kolor, aby były czytelne. Jeśli na przykład kolor przycisku jest ustawiony na niebieski, tekst i ikony na przycisku będą białe.

Aby ustawić kolor przycisku, określ wartość w polach red, green i blue. Wartość musi być liczbą zmiennoprzecinkową z zakresu od 0 do 1 opartą na wartości koloru RGB, gdzie 0 (0/255) oznacza brak koloru, a 1 (255/255) – maksymalną intensywność koloru.

Na przykład ten kod ustawia kolor czerwony o maksymalnej intensywności:

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

Pole alpha jest niedostępne w przypadku koloru przycisku. Jeśli to pole jest określone, jest ignorowane.
onClick

object (OnClick)

Wymagane. Działanie, które ma zostać wykonane, gdy użytkownik kliknie przycisk, np. otwarcie hiperlinku lub uruchomienie funkcji niestandardowej.
disabled

boolean

Jeśli true, przycisk jest wyświetlany w stanie nieaktywnym i nie reaguje na działania użytkownika.
altText

string

Tekst alternatywny używany na potrzeby ułatwień dostępu.

Ustaw tekst opisowy, który informuje użytkowników, co robi przycisk. Jeśli na przykład przycisk otwiera hiperlink, możesz napisać: „Otwiera nową kartę przeglądarki i przechodzi do dokumentacji dla deweloperów Google Chat na stronie https://developers.google.com/workspace/chat".
type

enum (Type)

Opcjonalnie. Typ przycisku. Jeśli nie ustawisz tego parametru, domyślnie zostanie użyty typ przycisku OUTLINED. Jeśli pole color jest ustawione, typ przycisku jest wymuszany na FILLED, a wszystkie wartości ustawione w tym polu są ignorowane.

Typ

Opcjonalnie. Typ przycisku. Jeśli pole color jest ustawione, pole type jest wymuszane na FILLED.

 Dostępne w przypadku aplikacji do Google Chat i niedostępne w przypadku dodatków do Google Workspace.

Wartości w polu enum
TYPE_UNSPECIFIED Nie używaj. Nie określono.
OUTLINED Przyciski z obramowaniem to przyciski o średnim znaczeniu. Zwykle zawierają działania, które są ważne, ale nie są głównym działaniem w aplikacji do Google Chat lub dodatku.
FILLED Wypełniony przycisk ma kontener z jednolitym kolorem. Ma największy wpływ wizualny i jest zalecany do ważnych i podstawowych działań w aplikacji Google Chat lub dodatku.
FILLED_TONAL Wypełniony przycisk tonalny to alternatywne rozwiązanie pośrednie między przyciskami wypełnionymi i z konturem. Są przydatne w kontekstach, w których przycisk o niższym priorytecie wymaga nieco większego wyróżnienia niż przycisk z obramowaniem.
BORDERLESS W stanie domyślnym przycisk nie ma niewidocznego kontenera. Często używa się go w przypadku działań o najniższym priorytecie, zwłaszcza gdy prezentowanych jest kilka opcji.