I componenti aggiuntivi di Google Workspace sono basati su schede. I componenti aggiuntivi dell'editor sono basati su HTML.
I componenti aggiuntivi presentano informazioni e controlli utente nella barra laterale dell'interfaccia utente dell'applicazione host. Un componente aggiuntivo di Google Workspace è costituito da una barra degli strumenti di identificazione principale insieme a una o più schede.
Ogni scheda rappresenta una particolare "pagina" dell'interfaccia utente del componente aggiuntivo. Passare a una nuova scheda di solito è solo una questione di creare la scheda e inserirla in una pila di schede interna. Puoi definire i flussi di navigazione tra le schede per un'esperienza di interazione avanzata.
Le schede possono essere non contestuali o contestuali. Le schede contestuali vengono mostrate all'utente quando l'applicazione host si trova in un contesto specifico, ad esempio quando apre un messaggio Gmail o un evento di Google Calendar. Le schede non contestuali (ad esempio le home page) vengono presentate all'utente al di fuori di un contesto specifico dell'host, ad esempio quando l'utente visualizza la posta in arrivo di Gmail, la cartella di Google Drive principale o Calendar.
I componenti aggiuntivi di Google Workspace creati in Google Apps Script utilizzano il servizio Card per creare interfacce utente da schede. I componenti aggiuntivi creati in altre lingue devono restituire un JSON formattato correttamente affinché l'interfaccia venga visualizzata come schede.
Ogni scheda è composta da un'intestazione e da una o più sezioni. Ogni sezione è composta da un insieme di widget. I widget mostrano informazioni all'utente o forniscono controlli di interazione come i pulsanti.
Le interfacce basate su schede presentano i seguenti vantaggi:
- Per creare interfacce basate su schede non è necessaria alcuna conoscenza di HTML o CSS.
- Le schede e i widget vengono formattati automaticamente per funzionare correttamente con le applicazioni Google Workspace che estendono.
- Le interfacce basate su schede funzionano sia su computer che su dispositivi mobili, ma devi definirle una sola volta.
Gmail è l'unica applicazione host che può essere estesa dai componenti aggiuntivi di Google Workspace sui dispositivi mobili.
Crea interfacce basate su schede
Quando crei componenti aggiuntivi basati su schede, è importante comprendere determinati concetti e pattern di progettazione. Le seguenti guide forniscono le informazioni necessarie per creare componenti aggiuntivi efficaci basati su schede:
- Schede
- Home page
- Widget
- Azioni
- Oggetti evento
- Costruire le schede
- Creazione di schede interattive
- Navigare tra le schede
- Utilizzare le azioni universali
- Aggiungere il completamento automatico agli input di testo
- Accedere alle impostazioni internazionali e ai fusi orari degli utenti
- Connessione a servizi non Google
- Guida di stile
- Best practice
Fai riferimento a queste pagine quando crei schede e implementi il comportamento dell'interfaccia utente. Potresti trovare utili anche i seguenti esempi aggiuntivi da consultare durante l'implementazione del componente aggiuntivo:
Guida rapida del componente aggiuntivo "Gatti" di Google Workspace
Questo esempio di componente aggiuntivo mostra un'interfaccia utente del componente aggiuntivo con più pagine e home page.
Componente aggiuntivo Google Workspace: "Traduci"
Questo esempio di componente aggiuntivo mostra un componente aggiuntivo che consente agli utenti di tradurre il testo da Documenti, Fogli e Presentazioni.
Componente aggiuntivo Google Workspace: "Elenco delle squadre"
Questo esempio di componente aggiuntivo mostra un esempio più complesso di componente aggiuntivo Google Workspace che mostra le informazioni utente su destinatari di messaggi Gmail, editor di file Drive o invitati a eventi di Calendar. Puoi utilizzare questo componente aggiuntivo solo all'interno di un dominio, poiché utilizza l'API Directory per recuperare le informazioni utente.