In questa pagina viene descritto come progettare e creare i componenti principali dell'interfaccia utente della scheda messaggi in Google Chat.
Le schede supportano un layout definito, elementi interattivi dell'interfaccia utente, come pulsanti rich media come immagini. Puoi utilizzare le schede per presentare informazioni, raccogliere input, o indicare i passaggi successivi agli utenti tramite messaggi card e finestre di dialogo.
Utilizza Card Builder per progettare e visualizzare l'anteprima di messaggi delle schede JSON per le app di chat:
Apri il generatore di schedeIn genere le schede e le finestre di dialogo includono i seguenti componenti:
- Un
CardHeader
che contiene il titolo della tua carta. - Uno o più widget
CardSection
che costituiscono il corpo principale della scheda. - Un widget
CardFixedFooter
specifico solo per le finestre di dialogo.
Prerequisiti
Aggiungi un'intestazione
Il widget CardHeader
che rappresenta l'intestazione di una scheda. Le intestazioni possono includere un
titolo, sottotitolo e immagine avatar per la tua scheda.
Puoi includere CardHeader
per
messaggi della scheda e
finestre di dialogo.
Di seguito è riportato un esempio di CardHeader
:
Definisci una sezione di una scheda
Il widget CardSection
è una
un contenitore di alto livello all'interno di una scheda. Utilizzi la carta
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
messaggi della scheda e
finestre di dialogo.
Di seguito è riportato un esempio di CardSection
che contiene due textParagraph
widget:
Aggiungi un piè di pagina permanente
La CardFixedFooter
rappresenta il piè di pagina di un messaggio della finestra di dialogo inviato
un'app di Chat.
I piè di pagina possono includere un pulsante principale e un pulsante secondario.
Il widget CardFixedFooter
è disponibile solo per
finestre di dialogo.
Di seguito è riportato un esempio di widget CardFixedFooter
con due pulsanti:
Risoluzione dei problemi
Quando un'app Google Chat o card restituisce un errore, L'interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte, l'UI di Chat non mostra alcun messaggio di errore, ma l'app Chat o la scheda restituisce un risultato inaspettato; Ad esempio, il messaggio di una scheda potrebbe non vengono visualizzate.
Anche se un messaggio di errore potrebbe non essere visualizzato nella UI di Chat, messaggi di errore descrittivi e dati di log che ti aiuteranno a correggere gli errori quando il logging degli errori per le app di chat è attivo. Per assistenza con la visualizzazione, il debug e la correzione degli errori, consulta Risolvere i problemi e correggere gli errori di Google Chat.