In questa pagina viene descritto come progettare e creare i componenti principali dell'interfaccia utente dei messaggi delle schede in Google Chat.
Le schede supportano un layout definito, elementi interattivi dell'interfaccia utente come pulsanti e rich media come le immagini. Puoi utilizzare le schede per presentare informazioni, raccogliere input o indicare i passaggi successivi agli utenti tramite messaggi di schede e finestre di dialogo.
Utilizza Card Builder per progettare e visualizzare l'anteprima dei messaggi delle schede JSON per le app di chat:
Apri Card BuilderIn genere, le schede e le finestre di dialogo presentano i componenti seguenti:
- Un elemento
CardHeader
contenente il titolo della carta. - Uno o più widget
CardSection
che costituiscono il corpo principale della scheda. - Un widget
CardFixedFooter
specifico solo per le finestre.
Prerequisiti
Aggiungi un'intestazione
Il widget CardHeader
rappresenta l'intestazione di una scheda. Le intestazioni possono includere un titolo,
un sottotitolo e un'immagine avatar per la scheda.
Puoi includere CardHeader
per i
messaggi a schede e le
finestre di dialogo.
Di seguito è riportato un esempio di CardHeader
:
Definire una sezione di una scheda
Il widget CardSection
è un
contenitore di alto livello all'interno di una scheda. Puoi utilizzare le sezioni delle schede
per raggruppare i widget all'interno di una scheda. Per ogni sezione della scheda puoi includere
un'intestazione e uno o più widget.
Puoi includere CardSection
per i
messaggi a schede e le
finestre di dialogo.
Di seguito è riportato un esempio di CardSection
che contiene due widget textParagraph
:
Aggiungi un piè di pagina permanente
Il widget CardFixedFooter
rappresenta il piè di pagina di un messaggio di dialogo inviato da un'app Chat. I piè di pagina possono includere un pulsante principale e un pulsante secondario.
Il widget CardFixedFooter
è disponibile solo per le
finestre.
Di seguito è riportato un esempio di widget CardFixedFooter
con due pulsanti:
Risolvi il problema
Quando un'app o una scheda Google Chat restituisce un errore, nell'interfaccia di Chat viene visualizzato il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte nella UI di Chat non vengono visualizzati messaggi di errore, ma l'app o la scheda di Chat produce un risultato imprevisto; ad esempio, un messaggio di scheda potrebbe non essere visualizzato.
Anche se un messaggio di errore potrebbe non essere visualizzato nell'interfaccia utente di Chat, sono disponibili messaggi di errore descrittivi e dati di log per aiutarti a correggere gli errori quando il logging degli errori per le app di Chat è attivato. Per assistenza su visualizzazione, debug e correzione degli errori, consulta l'articolo Risolvere gli errori di Google Chat.