Button

Bouton de texte, d'icône, ou de texte et d'icône sur lequel les utilisateurs peuvent cliquer. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un bouton.

Pour transformer une image en bouton cliquable, spécifiez un Image (et non un ImageComponent) et définissez une action onClick.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Représentation JSON 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
Champs
text

string

Texte affiché dans le bouton.
icon

object (Icon)

Icône affichée dans le bouton. Si les deux icontext sont définis, l'icône s'affiche avant le texte.
color

object (Color)

Facultatif. Couleur du bouton. Si cette option est définie, le bouton type est défini sur FILLED, et la couleur des champs text et icon est définie sur une couleur contrastée pour une meilleure lisibilité. Par exemple, si la couleur du bouton est définie sur bleu, le texte ou les icônes du bouton sont définis sur blanc.

Pour définir la couleur du bouton, spécifiez une valeur pour les champs red, green et blue. La valeur doit être un nombre à virgule flottante compris entre 0 et 1, basé sur la valeur de couleur RVB, où 0 (0/255) représente l'absence de couleur et 1 (255/255) représente l'intensité maximale de la couleur.

Par exemple, la commande suivante définit la couleur sur rouge à son intensité maximale :

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

Le champ alpha n'est pas disponible pour la couleur du bouton. S'il est spécifié, ce champ est ignoré.
onClick

object (OnClick)

Obligatoire. Action à effectuer lorsqu'un utilisateur clique sur le bouton, par exemple ouvrir un lien hypertexte ou exécuter une fonction personnalisée.
disabled

boolean

Si la valeur est true, le bouton est affiché dans un état inactif et ne répond pas aux actions de l'utilisateur.
altText

string

Texte alternatif utilisé pour l'accessibilité.

Définissez un texte descriptif qui indique aux utilisateurs ce que fait le bouton. Par exemple, si un bouton ouvre un lien hypertexte, vous pouvez écrire : "Ouvre un nouvel onglet de navigateur et accède à la documentation pour les développeurs Google Chat à l'adresse https://developers.google.com/workspace/chat".
type

enum (Type)

Facultatif. Type d'un bouton. Si ce champ n'est pas défini, le type de bouton est défini par défaut sur OUTLINED. Si le champ color est défini, le type de bouton est forcé sur FILLED et toute valeur définie pour ce champ est ignorée.

Type

Facultatif. Le type d'un bouton. Si le champ color est défini, type est forcé sur FILLED.

 Disponible pour les applications Google Chat et non disponible pour les modules complémentaires Google Workspace.

Enums
TYPE_UNSPECIFIED À ne pas utiliser. Non spécifié.
OUTLINED Les boutons avec contour sont des boutons d'emphase moyenne. Ils contiennent généralement des actions importantes, mais qui ne sont pas l'action principale dans une application Chat ou un module complémentaire.
FILLED Un bouton rempli comporte un conteneur d'une couleur unie. Il a le plus d'impact visuel et est recommandé pour l'action principale et importante dans une application Chat ou un module complémentaire.
FILLED_TONAL Un bouton rempli tonal est une alternative intermédiaire entre les boutons remplis et les boutons avec contour. Ils sont utiles dans les contextes où un bouton de priorité inférieure nécessite un peu plus d'importance qu'un bouton avec contour.
BORDERLESS Un bouton ne comporte pas de conteneur invisible dans son état par défaut. Il est souvent utilisé pour les actions de priorité la plus faible, en particulier lorsque plusieurs options sont présentées.