Un module complémentaire basé sur des fiches s'affiche sous la forme d'un volet dans la barre latérale (ou, sur mobile, sous la forme d'une autre fenêtre d'activité accessible via le menu). Le module complémentaire comporte 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 cartes dans le code du projet à l'aide d'objets Card.
Anatomie d'une fiche
Une fiche est un groupe d'éléments d'interface utilisateur que vous concevez. Une fiche se compose des sections suivantes:
- En-tête de fiche Cela permet d'identifier les cartes. Il comporte un titre, et peut éventuellement comporter un sous-titre et une icône.
Une ou plusieurs sections de fiche Il s'agit de sous-divisions de la zone de l'UI de la fiche. Une section peut éventuellement comporter un en-tête de section textuel. Les sections de la fiche sont séparées les unes des autres par une ligne horizontale. Si une section de fiche est particulièrement volumineuse, elle est automatiquement affichée sous forme de section réductible que les utilisateurs peuvent développer ou réduire selon leurs besoins. Une fiche ne peut comporter pas plus de 100 sections et ne doit en contenir que quelques-unes pour améliorer les performances.
Chaque section de fiche contient un ou plusieurs widgets d'interface utilisateur. Les widgets fournissent à l'utilisateur des informations ou des commandes interactives. Les fiches et les sections de fiches sont des widgets structuraux. Vous ne pouvez donc pas les ajouter à une section de fiches. Une section de fiches ne peut contenir pas plus de 100 widgets et doit être aussi simple que possible pour des performances optimales.
Vous devez concevoir des fiches en fonction d'activités ou d'ensembles de données utilisateur spécifiques. Par exemple, un module complémentaire Google Workspace qui affiche des données extraites de Google Sheets peut avoir 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 cartes. Vous pouvez configurer ces cartes en tant que liste simple pour une navigation de base avec plusieurs cartes ou configurer des méthodes de navigation plus complexes pour contrôler la façon dont l'utilisateur passe d'une carte à l'autre.
Si le module complémentaire utilise la navigation de base, lorsque le module complémentaire est ouvert pour la première fois, l'application Google Workspace qu'il étend crée une liste des 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 des en-têtes de carte. Vous n'avez pas besoin de coder la fonctionnalité d'en-tête et de flèche de retour. Cela se fait automatiquement lorsque vous définissez les fiches dans votre module complémentaire.
Lorsque vous concevez des modules complémentaires, il est préférable de limiter le nombre de fiches que vous affichez à la fois, car elles doivent partager un espace d'écran limité. Nous vous recommandons également d'éviter toute complexité inutile dans les fiches.