Button

Eine Schaltfläche mit Text, Symbol oder Text und Symbol, auf die Nutzer klicken können. Ein Beispiel für Google Chat-Apps finden Sie unter Schaltfläche hinzufügen.

Wenn Sie ein Bild zu einer anklickbaren Schaltfläche machen möchten, geben Sie ein Image-Element (kein ImageComponent-Element) an und legen Sie eine onClick-Aktion fest.

Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.

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

string

Der Text, der auf der Schaltfläche angezeigt wird.
icon

object (Icon)

Ein Symbol, das auf der Schaltfläche angezeigt wird. Wenn sowohl icon als auch text festgelegt sind, wird das Symbol vor dem Text angezeigt.
color

object (Color)

Optional. Die Farbe des Buttons. Wenn diese Option festgelegt ist, wird der Button type auf FILLED gesetzt und die Farbe der Felder text und icon wird auf eine Kontrastfarbe gesetzt, um die Lesbarkeit zu verbessern. Wenn die Schaltflächenfarbe beispielsweise auf Blau festgelegt ist, werden alle Texte oder Symbole in der Schaltfläche auf Weiß gesetzt.

Wenn Sie die Buttonfarbe festlegen möchten, geben Sie einen Wert für die Felder red, green und blue an. Der Wert muss eine Gleitkommazahl zwischen 0 und 1 sein, die auf dem RGB-Farbwert basiert. Dabei steht 0 (0/255) für das Fehlen von Farbe und 1 (255/255) für die maximale Intensität der Farbe.

Im folgenden Beispiel wird die Farbe Rot mit maximaler Intensität festgelegt:

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

Das Feld alpha ist für die Schaltflächenfarbe nicht verfügbar. Wenn angegeben, wird dieses Feld ignoriert.
onClick

object (OnClick)

Erforderlich. Die Aktion, die ausgeführt werden soll, wenn ein Nutzer auf die Schaltfläche klickt, z. B. das Öffnen eines Hyperlinks oder das Ausführen einer benutzerdefinierten Funktion.
disabled

boolean

Wenn true, wird die Schaltfläche in einem inaktiven Zustand angezeigt und reagiert nicht auf Nutzeraktionen.
altText

string

Der alternative Text, der für die Barrierefreiheit verwendet wird.

Legen Sie einen beschreibenden Text fest, der Nutzern mitteilt, was die Schaltfläche bewirkt. Wenn eine Schaltfläche beispielsweise einen Hyperlink öffnet, können Sie Folgendes schreiben: „Öffnet einen neuen Browsertab und ruft die Entwicklerdokumentation für Google Chat unter https://developers.google.com/workspace/chat" auf.“
type

enum (Type)

Optional. Der Typ einer Schaltfläche. Wenn nicht festgelegt, ist der Standard-Schaltflächentyp OUTLINED. Wenn das Feld color festgelegt ist, wird der Schaltflächentyp auf FILLED gesetzt und alle für dieses Feld festgelegten Werte werden ignoriert.

Typ

Optional. Der Typ einer Schaltfläche. Wenn das Feld color festgelegt ist, wird type auf FILLED gesetzt.

Verfügbar für Google Chat-Apps und nicht verfügbar für Google Workspace-Add-ons.

Enums
TYPE_UNSPECIFIED Nicht verwenden. Nicht angegeben
OUTLINED Schaltflächen mit Umriss sind Schaltflächen mit mittlerer Gewichtung. Sie enthalten in der Regel Aktionen, die wichtig sind, aber nicht die primäre Aktion in einer Chat-App oder einem Add-on darstellen.
FILLED Eine Schaltfläche mit Füllung hat einen Container mit einer Volltonfarbe. Sie hat die größte visuelle Wirkung und wird für die wichtigste und primäre Aktion in einer Chat-App oder einem Add-on empfohlen.
FILLED_TONAL Eine Schaltfläche mit Füllung und Tonwert ist ein alternativer Mittelweg zwischen Schaltflächen mit Füllung und Schaltflächen mit Umriss. Sie sind nützlich, wenn eine Schaltfläche mit niedrigerer Priorität etwas mehr hervorgehoben werden soll, als es mit einer Schaltfläche mit Umriss möglich wäre.
BORDERLESS Ein Button hat im Standardzustand keinen unsichtbaren Container. Sie wird häufig für Aktionen mit der niedrigsten Priorität verwendet, insbesondere wenn mehrere Optionen präsentiert werden.