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é est atteinte via le menu). Le module complémentaire dispose d'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 d'un projet à l'aide d'objets Card.
Anatomie de la carte
Une carte est un groupe d'éléments d'interface utilisateur que vous concevez. Une fiche comprend les sections suivantes:
- En-tête de fiche : Cette valeur permet d'identifier les cartes. Elle a un texte de titre, et peut éventuellement avoir un sous-titre et une icône.
Une ou plusieurs sections de fiche. Il s'agit des sous-divisions 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 comporter plus de 100 sections et ne doit en comporter 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 "Fiche" sont des widgets structurels. Vous ne pouvez donc pas les ajouter à une section de fiche. Une section de fiche ne peut pas comporter plus de 100 widgets et doit être aussi simple que possible pour obtenir des performances optimales.
Vous devez concevoir des fiches autour d'activités ou de jeux de données utilisateur particuliers. Par exemple, un module complémentaire Google Workspace qui affiche les données extraites de Google Sheets peut disposer d'une fiche distincte pour chaque feuille dont il extrait les données.
Utiliser plusieurs cartes
Les modules complémentaires comportent généralement plusieurs fiches. Vous pouvez soit configurer ces fiches sous la forme d'une simple liste pour la navigation de base avec plusieurs fiches, soit 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, lors de sa première ouverture, l'application Google Workspace étend une liste des en-têtes de carte et les présente à l'utilisateur. Cliquer sur l'en-tête de la carte ouvre cette fiche. Une flèche de retour est également fournie pour revenir à la liste d'en-têtes de la carte. Vous n'avez pas besoin de coder les fonctionnalités d'en-tête et de flèche de retour. Cette opération s'effectue 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 simultanément, car celles-ci doivent partager un espace limité à l'écran. Il est également préférable d'éviter la complexité inutile des fiches.