Un module complémentaire basé sur une fiche apparaît sous la forme d'un volet dans la barre latérale (ou, sur mobile, lorsqu'une autre fenêtre d'activité s'affiche via le menu). Le module complémentaire possède une barre d'outils supérieure qui l'identifie et affiche une fiche, essentiellement une "page" de l'interface utilisateur du module complémentaire. Apps Script représente les fiches dans le code du projet à l'aide d'objets Card.
Anatomie d'une carte
Une fiche est un groupe d'éléments d'UI que vous concevez. Une fiche comprend les sections suivantes:
- Un en-tête de fiche. Cela permet d'identifier les fiches. Il comporte un titre, et éventuellement un sous-titre et une icône.
Une ou plusieurs sections de fiches : Il s'agit de sous-divisions de la zone de l'interface utilisateur de la fiche. Une section peut éventuellement comporter un en-tête de section de texte. Les sections de la fiche sont séparées les unes des autres par une règle horizontale. Si une section de fiche est particulièrement grande, elle est automatiquement affichée sous la forme d'une section réductible que les utilisateurs peuvent développer ou réduire si nécessaire. Une fiche ne peut pas contenir plus de 100 sections de fiches. Pour des performances optimales, il n'est pas nécessaire d'en ajouter quelques-unes.
Chaque section de la fiche contient un ou plusieurs widgets d'interface utilisateur. Les widgets fournissent des informations ou des commandes interactives à l'utilisateur. Les fiches et les sections de fiches sont des widgets structuraux. Vous ne pouvez donc pas les ajouter à une section de fiche. Une section de fiche ne peut pas contenir plus de 100 widgets et doit être aussi simple que possible pour de meilleures performances.
Vous devez concevoir des fiches axées sur des activités utilisateur ou des ensembles de données spécifiques. Par exemple, un module complémentaire Google Workspace qui affiche les données issues de Google Sheets peut disposer d'une fiche distincte pour chaque feuille à partir de laquelle il extrait des données.
Utiliser plusieurs fiches
Les modules complémentaires comportent généralement plusieurs fiches. Vous pouvez configurer ces cartes sous la forme d'une simple liste pour la navigation de base avec plusieurs cartes, ou configurer des méthodes de navigation plus complexes pour contrôler la manière dont l'utilisateur passe d'une fiche à une autre.
Si le module complémentaire utilise la navigation de base, lorsqu'il ouvre l'application Google Workspace pour la première fois, il développe une liste d'en-têtes de carte et les présente à l'utilisateur. Cliquez sur l'en-tête de la fiche pour l'ouvrir. Une flèche de retour est également fournie pour revenir à la liste d'en-tête de la fiche. Vous n'avez pas besoin de coder la fonctionnalité d'en-tête ni de flèche de retour. Cette opération est effectuée automatiquement lorsque vous définissez les fiches dans votre module complémentaire.
Lors de la conception de modules complémentaires, il est préférable de limiter le nombre de fiches que vous souhaitez afficher en même temps, car elles doivent partager un espace limité. Il est également préférable d'éviter toute complexité inutile dans les fiches.