Button

Un pulsante di testo, icona o testo e icona su cui gli utenti possono fare clic. Per un esempio nelle app Google Chat, vedi Aggiungi un pulsante.

Per rendere un'immagine un pulsante cliccabile, specifica un Image (non un ImageComponent) e imposta un'azione onClick.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

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

string

Il testo visualizzato all'interno del pulsante.
icon

object (Icon)

Un'icona visualizzata all'interno del pulsante. Se vengono impostati sia icon che text, l'icona viene visualizzata prima del testo.
color

object (Color)

Facoltativo. Il colore del pulsante. Se impostato, il pulsante type viene impostato su FILLED e il colore dei campi text e icon viene impostato su un colore a contrasto per garantire la leggibilità. Ad esempio, se il colore del pulsante è impostato su blu, il testo o le icone nel pulsante sono impostati su bianco.

Per impostare il colore del pulsante, specifica un valore per i campi red, green e blue. Il valore deve essere un numero in virgola mobile compreso tra 0 e 1 in base al valore del colore RGB, dove 0 (0/255) rappresenta l'assenza di colore e 1 (255/255) rappresenta l'intensità massima del colore.

Ad esempio, il seguente codice imposta il colore su rosso alla massima intensità:

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

Il campo alpha non è disponibile per il colore del pulsante. Se specificato, questo campo viene ignorato.
onClick

object (OnClick)

Obbligatorio. L'azione da eseguire quando un utente fa clic sul pulsante, ad esempio l'apertura di un link ipertestuale o l'esecuzione di una funzione personalizzata.
disabled

boolean

Se true, il pulsante viene visualizzato in uno stato non attivo e non risponde alle azioni dell'utente.
altText

string

Il testo alternativo utilizzato per l'accessibilità.

Imposta un testo descrittivo che consenta agli utenti di sapere cosa fa il pulsante. Ad esempio, se un pulsante apre un link ipertestuale, puoi scrivere: "Apre una nuova scheda del browser e indirizza alla documentazione per lo sviluppo di Google Chat all'indirizzo https://developers.google.com/workspace/chat".
type

enum (Type)

Facoltativo. Il tipo di pulsante. Se non viene impostato, il tipo di pulsante predefinito è OUTLINED. Se il campo color è impostato, il tipo di pulsante viene forzato su FILLED e qualsiasi valore impostato per questo campo viene ignorato.

Tipo

Facoltativo. Il tipo di un pulsante. Se il campo color è impostato, type viene forzato su FILLED.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Enum
TYPE_UNSPECIFIED Non utilizzare. Non specificato.
OUTLINED I pulsanti con contorno sono pulsanti con enfasi media. In genere contengono azioni importanti, ma non l'azione principale di un'app di Chat o di un componente aggiuntivo.
FILLED Un pulsante con riempimento ha un container con un colore a tinta unita. Ha il maggiore impatto visivo ed è consigliato per l'azione importante e principale in un'app di Chat o in un componente aggiuntivo.
FILLED_TONAL Un pulsante con tonalità piena è un'alternativa intermedia tra i pulsanti con riempimento e quelli con contorno. Sono utili in contesti in cui un pulsante con priorità inferiore richiede un'enfasi leggermente maggiore rispetto a quella che darebbe un pulsante con contorno.
BORDERLESS Un pulsante non ha un container invisibile nello stato predefinito. Viene spesso utilizzato per le azioni con priorità più bassa, soprattutto quando vengono presentate più opzioni.