Un componente aggiuntivo basato su schede viene visualizzato come riquadro nella barra laterale (oppure, 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. Apps Script rappresenta le schede nel codice del progetto utilizzando oggetti Card.
Struttura delle schede
Una scheda è un gruppo di elementi dell'interfaccia utente progettati da te. Una scheda è costituita dalle seguenti sezioni:
- L'intestazione di una scheda. che identifica le schede. Include il testo del titolo e, facoltativamente, può avere un sottotitolo e un'icona.
Una o più sezioni della scheda. Si tratta di suddivisioni dell'area UI della scheda. Facoltativamente, una sezione può avere un'intestazione di testo. Sulla scheda, le sezioni delle schede sono separate da una riga orizzontale. Se la sezione di una scheda è particolarmente grande, viene visualizzata automaticamente come sezione comprimibile che gli utenti possono espandere o comprimere a seconda delle esigenze. Per migliorare il rendimento, una scheda non può avere più di 100 sezioni e ne dovrebbero includere 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 relative sezioni sono widget strutturali, quindi non puoi aggiungerli a una sezione della scheda. La sezione di una scheda non può avere più di 100 widget e dovrebbe essere il più semplice possibile per ottenere il miglior rendimento possibile.
Dovresti progettare le schede in base a determinati set di dati o attività utente. Ad esempio, un componente aggiuntivo di Google Workspace che mostra i dati acquisiti da Fogli Google potrebbe avere una scheda separata per ogni foglio da cui estrae i dati.
Utilizzo di più carte
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 passa da una scheda all'altra.
Se il componente aggiuntivo utilizza la navigazione di base, quando viene aperto per la prima volta, l'applicazione Google Workspace estende crea un elenco di intestazioni delle schede e le presenta all'utente. Se fai clic sull'intestazione della scheda, la si apre. È disponibile anche una freccia indietro per tornare all'elenco delle intestazioni della scheda. Non è necessario codificare le funzionalità Intestazione e Freccia indietro: questa operazione viene eseguita automaticamente quando definisci le schede nel tuo componente aggiuntivo.
Quando progetti componenti aggiuntivi, ti consigliamo di limitare il numero di schede che vengono visualizzate contemporaneamente, poiché le schede devono condividere una quantità limitata di spazio sullo schermo. Inoltre, è meglio evitare complessità non necessarie nelle schede.