Interfaces basées sur des cartes

Exemple de fiche complémentaire

Les modules complémentaires Google Workspace 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 se compose d'une barre d'outils d'identification principale, ainsi que d'une ou plusieurs fiches.

Chaque carte représente une "page" spécifique de l'interface utilisateur de votre module complémentaire. Pour accéder à une nouvelle carte, il suffit généralement de la créer et de la transmettre dans une pile de cartes interne. Vous pouvez définir des flux de navigation entre les fiches pour une expérience d'interaction enrichie.

Les fiches peuvent être non contextuelles ou contextuelles. Les fiches contextuelles sont présentées à l'utilisateur lorsque l'application hôte se trouve dans un contexte spécifique. par exemple à l'ouverture d'un message Gmail ou d'un événement 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 Drive principal ou Agenda).

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

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

Les interfaces à cartes présentent les avantages suivants:

  • Aucune connaissance du langage HTML ou CSS n'est nécessaire pour créer des interfaces basées sur des fiches.
  • Les fiches et les widgets sont automatiquement stylisés pour fonctionner correctement avec les applications Google Workspace qu'ils étendent.
  • Les interfaces basées sur des cartes fonctionnent à la fois sur les ordinateurs et sur les appareils mobiles, mais vous ne devez les définir qu'une seule fois.

Créer des interfaces basées sur des cartes

Lorsque vous créez des modules complémentaires basés sur des fiches, 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 cartes:

Reportez-vous à ces pages lorsque vous créez des fiches et implémentez le comportement de l'interface utilisateur. Les exemples supplémentaires suivants peuvent également vous être utiles lorsque vous implémentez votre module complémentaire: