Progettare i componenti di una scheda o di una finestra di dialogo

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.

Progetta e visualizza l'anteprima delle schede con Card Builder.

Apri Card Builder

In 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

  • Un account Google Workspace con accesso a Google Chat.
  • Un'app di Chat pubblicata. Per creare un'app di Chat, segui questa quickstart.

    • 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:

    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 nell'interfaccia utente di Chat non vengono visualizzati messaggi di errore, ma l'app o la scheda Chat produce un risultato imprevisto; ad esempio, è possibile che non venga visualizzato un messaggio di scheda.

    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 la registrazione degli errori per le app di Chat è attivata. Per informazioni su visualizzazione, debug e correzione degli errori, consulta l'articolo Risolvere gli errori di Google Chat.