Carte

Un componente aggiuntivo di Google Workspace basato su schede viene visualizzato come riquadro nella barra laterale o, sui dispositivi mobili, come un'altra finestra di attività accessibile tramite il menu. Il componente aggiuntivo ha una barra degli strumenti in alto che lo identifica e mostra una scheda, ovvero una "pagina" dell'interfaccia utente del componente aggiuntivo. Google Apps Script rappresenta le schede nel codice del progetto utilizzando Card oggetti.

Anatomia di una scheda

Esempio di carta aggiuntiva che mostra i dati di contatto

Una scheda è un gruppo di elementi dell'interfaccia utente che progetti. Una scheda è composta dalle seguenti sezioni:

  • Un'intestazione della scheda. Identifica le schede. Contiene il testo del titolo e, facoltativamente, un sottotitolo e un'icona.
  • Una o più sezioni della scheda. Sono suddivisioni dell'area dell'interfaccia utente della scheda. Una sezione può avere un'intestazione di sezione di testo. Le sezioni delle schede sono separate l'una dall'altra da una regola orizzontale. Se una sezione della scheda è particolarmente grande, viene eseguito automaticamente il rendering come sezione comprimibile che gli utenti possono espandere o comprimere in base alle esigenze. Una scheda può avere al massimo 100 sezioni, e, per un rendimento migliore, dovrebbe averne solo alcune.

  • Ogni sezione della scheda contiene uno o più widget dell'interfaccia utente . I widget forniscono all'utente informazioni o controlli interattivi. Le schede e le sezioni delle schede sono widget strutturali, quindi non puoi aggiungerli a una sezione della scheda. Una sezione della scheda può avere al massimo 100 widget, e, per un rendimento ottimale, deve essere il più concisa possibile.

Dovresti progettare le schede in base a particolari attività utente o set di dati. Ad esempio, un componente aggiuntivo di Google Workspace che visualizza i dati estratti da Fogli Google potrebbe avere una scheda separata per ogni foglio da cui estrae i dati.

Utilizzare più schede

Scheda del componente aggiuntivo di esempio che mostra una semplice UI

In genere, i componenti aggiuntivi sono costituiti da più di una scheda. Puoi configurare queste schede come un elenco per la navigazione di base o configurare metodi di navigazione più complessi per controllare il modo in cui l'utente si sposta tra le schede. Per maggiori dettagli, vedi Navigazione di base con più schede.

Se il componente aggiuntivo utilizza la navigazione di base, quando viene aperto per la prima volta l'applicazione Google Workspace che estende, crea un elenco delle intestazioni delle schede e le presenta all'utente. Se fai clic sull'intestazione della scheda, si apre la scheda. Viene fornita anche una freccia indietro per tornare all'elenco delle intestazioni delle schede. Non devi codificare la funzionalità dell'intestazione e della freccia indietro: questa operazione viene eseguita automaticamente quando definisci le schede nel componente aggiuntivo.

Quando progetti i componenti aggiuntivi, è consigliabile limitare il numero di schede visualizzate contemporaneamente, poiché le schede devono condividere una quantità limitata di spazio sullo schermo. È anche consigliabile evitare complessità inutili nelle schede.

Per motivi di rendimento, non puoi aggiungere più di 100 widget o 100 sezioni di schede a una scheda.