Carte

Un componente aggiuntivo basato su schede viene visualizzato come riquadro nella barra laterale (o, su dispositivi mobili, come un'altra finestra di attività raggiungibile 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. Apps Script rappresenta le schede nel codice del progetto utilizzando gli oggetti Card.

Anatomia della scheda

Scheda di esempio del componente aggiuntivo

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

  • Un'intestazione della scheda. In questo modo le schede vengono identificate. Ha un testo del titolo e, facoltativamente, un sottotitolo e un'icona.
  • Una o più sezioni della scheda. Si tratta di suddivisioni dell'area dell'interfaccia utente della scheda. Una sezione può avere facoltativamente un'intestazione di sezione di testo. Le sezioni della scheda sono separate da una linea orizzontale. Se una sezione della scheda è particolarmente grande, viene visualizzata automaticamente come sezione comprimibile che gli utenti possono espandere o comprimere in base alle esigenze. Una scheda può avere massimo 100 sezioni e dovrebbe averne solo alcune per un rendimento migliore.

  • 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, pertanto non puoi aggiungerle a una sezione delle schede. Una sezione della scheda può contenere non più di 100 widget e deve essere il più semplice possibile per ottenere il miglior rendimento.

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

Utilizzo di più schede

Scheda di esempio del componente aggiuntivo

I componenti aggiuntivi di solito sono costituiti da più di una scheda. Puoi configurare queste schede come un semplice elenco per la navigazione di base con più schede oppure configurare metodi di navigazione più complessi per controllare il modo in cui l'utente si sposta tra le schede.

Se il componente aggiuntivo utilizza la navigazione di base, quando viene aperto per la prima volta, l'applicazione Google Workspace che estende il componente aggiuntivo crea un elenco delle intestazioni delle schede e le presenta all'utente. Se fai clic sull'intestazione della scheda, la scheda si apre. È presente anche una freccia Indietro per tornare all'elenco degli intestazioni della scheda. 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, è meglio limitare il numero di schede visualizzate contemporaneamente, poiché le schede devono condividere uno spazio sullo schermo limitato. Inoltre, è meglio evitare complessità non necessarie nelle schede.