Un componente aggiuntivo basato su schede viene visualizzato come riquadro nella barra laterale (o, sui dispositivi mobili, come un'altra
finestra di attività raggiungibile tramite il menu). Il componente aggiuntivo ha una barra degli strumenti superiore che
identifica il componente aggiuntivo 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.
Anatomia della scheda
Una scheda è un gruppo di elementi dell'interfaccia utente che progetti. Una scheda è costituita dalle seguenti sezioni:
- Un'intestazione della scheda. Identifica le carte. Contiene il testo del titolo e, facoltativamente, un sottotitolo e un'icona.
Una o più sezioni delle schede. Si tratta di suddivisioni dell'area dell'interfaccia utente della scheda. Una sezione può facoltativamente avere un'intestazione di sezione di testo. Le sezioni della scheda sono separate l'una dall'altra 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 non più di 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, quindi non puoi aggiungerli a una sezione della scheda. 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 specifiche attività utente o set di dati. Ad esempio, un componente aggiuntivo Google Workspace che mostra i dati estratti da Fogli Google potrebbe avere una scheda separata per ogni foglio da cui estrae i dati.
Utilizzo di più carte
In genere, i componenti aggiuntivi sono costituiti da più di una carta. 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, viene creata una lista delle intestazioni delle schede e presentata all'utente. Se fai clic sull'intestazione della scheda, questa si apre. Viene fornita anche una freccia indietro per tornare all'elenco delle intestazioni delle schede. Non devi codificare la funzionalità di intestazione e freccia indietro. Questa operazione viene eseguita automaticamente quando definisci le schede nel componente aggiuntivo.
Quando progetti componenti aggiuntivi, è consigliabile limitare il numero di schede che visualizzi contemporaneamente, poiché le schede devono condividere una quantità limitata di spazio sullo schermo. Inoltre, è consigliabile evitare inutili complessità nelle schede.