Carte

Un componente aggiuntivo basato su schede viene visualizzato come riquadro nella barra laterale (o sui dispositivi mobili sotto forma di finestra dell'attività raggiunta tramite il menu). Il componente aggiuntivo ha una barra degli strumenti superiore identifica il componente aggiuntivo e mostra una scheda, essenzialmente una "pagina" del nell'interfaccia utente del componente aggiuntivo. Apps Script rappresenta le schede nel codice del progetto utilizzando Card oggetti.

Anatomia delle carte

Esempio di scheda del componente aggiuntivo

Una scheda è un gruppo di elementi UI che progetti. Una carta è costituita da sezioni seguenti:

  • L'intestazione di una scheda. per identificare le carte. Ha il testo del titolo e potrebbe facoltativamente avere un sottotitolo e un'icona.
  • Una o più sezioni della scheda. Si tratta di suddivisioni dell'area UI della scheda. Una sezione può facoltativamente avere un'intestazione di sezione di testo. Le sezioni della scheda sono separate l'una dall'altra all'interno di una scheda da una riga orizzontale. Se una sezione di una scheda è particolarmente grande, viene visualizzata automaticamente come sezione comprimibile che gli utenti possono espandere o comprimere a seconda delle esigenze. Una scheda può avere non più di 100 sezioni, e dovrebbero averne solo pochi per migliorare le prestazioni.

  • Ogni sezione della scheda contiene una o più UI widget. I widget offrono all'utente informazioni o controlli interattivi. Le schede e le sezioni delle schede sono strutturali, quindi non puoi aggiungerli a una sezione di schede. Una carta La sezione non può avere non più di 100 widget, e deve essere il più semplice possibile per ottenere le migliori prestazioni.

Dovresti progettare schede relative a particolari attività o set di dati degli utenti. Per Ad esempio, un componente aggiuntivo di Google Workspace che mostra dati presi da Fogli Google potrebbe avere una scheda separata per ogni foglio che estrae da cui proviene.

Utilizzo di più carte

Esempio di scheda del componente aggiuntivo

I componenti aggiuntivi di solito sono costituiti da più di una scheda. Puoi configurare questi come un semplice elenco navigazione di base con più schede, o configurare applicazioni metodi di navigazione per controllare in che modo l'utente si sposta da una scheda all'altra.

Se il componente aggiuntivo utilizza la navigazione di base, quando viene aperto per la prima volta estende l'applicazione Google Workspace. l'elenco delle intestazioni delle schede e le presenta all'utente. Facendo clic sulla scheda per aprire la scheda. Viene mostrata anche una Freccia indietro per tornare alla scheda dell'elenco di intestazioni. Non è necessario codificare l'intestazione e la freccia indietro questa funzionalità viene eseguita automaticamente quando definisci le schede come componente aggiuntivo.

Quando si progettano i componenti aggiuntivi, limitare il numero di carte che vengono visualizzati contemporaneamente, in quanto le schede devono condividere una quantità limitata di spazio sullo schermo. È inoltre meglio evitare le complessità superflue delle schede.