Interfaces basées sur des cartes

Les modules complémentaires Google Workspace sont basés sur des fiches. Les modules complémentaires de l'éditeur sont basés sur HTML.

Exemple d'interface de fiche de module complémentaire Google Workspace.

Les modules complémentaires présentent des informations et des commandes utilisateur dans la barre latérale de l'interface utilisateur de l'application hôte. Un module complémentaire Google Workspace se compose d'une barre d'outils d'identification principale et d'une ou plusieurs fiches.

Chaque fiche représente une "page" spécifique de l'interface utilisateur de votre module complémentaire. Accéder à une nouvelle fiche consiste généralement à créer cette fiche et à la transférer vers une pile de fiches interne. Vous pouvez définir des flux de navigation entre les cartes pour une expérience d'interaction enrichie.

Les fiches peuvent être non contextuelles ou contextuelles. Les cartes contextuelles sont présentées à l'utilisateur lorsque l'application hôte se trouve dans un contexte spécifique, par exemple lorsqu'il ouvre un message Gmail ou un événement Google Agenda. Les fiches non contextuelles (telles que les pages d'accueil) sont présentées à l'utilisateur en dehors d'un contexte spécifique de l'hôte, par exemple lorsque l'utilisateur consulte sa boîte de réception Gmail, son dossier Google Drive principal ou son agenda.

Les modules complémentaires Google Workspace créés dans Google Apps Script utilisent le service Card pour créer des interfaces utilisateur à partir de cartes. Les modules complémentaires créés dans d'autres langues doivent renvoyer un fichier JSON correctement mis en forme pour que l'interface s'affiche sous forme de fiches.

Chaque fiche se compose d'un en-tête et d'une ou plusieurs sections. Chaque section est composée d'un ensemble de widgets. Les widgets affichent des informations à l'utilisateur ou fournissent des commandes d'interaction telles que des boutons.

Les interfaces basées sur des cartes présentent les avantages suivants :

  • Aucune connaissance en HTML ou CSS n'est requise pour créer des interfaces basées sur des cartes.
  • Les cartes et les widgets sont automatiquement mis en forme pour fonctionner correctement avec les applications Google Workspace qu'ils étendent.
  • Les interfaces basées sur des fiches fonctionnent à la fois sur les ordinateurs et les appareils mobiles, mais vous n'avez besoin de définir l'interface qu'une seule fois.

Gmail est la seule application hôte qui peut être étendue par les modules complémentaires Google Workspace sur mobile.

Créer des interfaces basées sur des cartes

Lorsque vous créez des modules complémentaires basés sur des cartes, il est important de comprendre certains concepts et modèles de conception. Les guides suivants fournissent les informations dont vous avez besoin pour créer des modules complémentaires efficaces basés sur des fiches :

Consultez ces pages lorsque vous créez des fiches et implémentez le comportement de l'UI. Les exemples supplémentaires suivants peuvent également vous être utiles lors de l'implémentation de votre module complémentaire :