Un module complémentaire Google Workspace basé sur des cartes apparaît sous forme de volet dans la barre latérale (ou, sur mobile, sous 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 carte , qui est essentiellement une "page"
de l'interface utilisateur du module complémentaire. Google Apps Script represents
cartes dans le code du projet à l'aide d'objets Card.
Anatomie d'une carte
Une carte est un groupe d'éléments d'interface utilisateur que vous concevez. Une carte comprend les sections suivantes :
- Un en-tête de carte. Il identifie les cartes. Il comporte un texte de titre et peut éventuellement comporter un sous-titre et une icône.
Une ou plusieurs sections de carte. Il s'agit de sous-divisions de la zone d'interface utilisateur de la carte. Une section peut comporter un en-tête de section de texte. Les sections de carte sont séparées les unes des autres par une règle horizontale. Si une section de carte 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 carte ne peut pas comporter plus de 100 sections de carte, et ne doit en comporter que quelques-unes pour de meilleures performances.
Chaque section de carte contient un ou plusieurs widgets d'interface utilisateur . Les widgets fournissent à l'utilisateur des informations ou des commandes interactives. Les cartes et les sections de carte sont des widgets structurels. Vous ne pouvez donc pas les ajouter à une section de carte. Une section de carte ne peut pas comporter plus de 100 widgets, et doit être aussi concise que possible pour de meilleures performances.
Vous devez concevoir des cartes autour d'activités utilisateur ou d'ensembles de données spécifiques. Par exemple, un module complémentaire Google Workspace qui affiche des données extraites de Google Sheets peut comporter une carte distincte pour chaque feuille à partir de laquelle il extrait des données.
Utiliser plusieurs cartes
Les modules complémentaires comportent généralement plusieurs cartes. Vous pouvez soit configurer ces cartes sous forme de liste pour une navigation de base, soit configurer des méthodes de navigation plus complexes pour contrôler la façon dont l'utilisateur passe d'une carte à une autre. Pour en savoir plus, consultez Navigation de base avec plusieurs cartes.
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 construit une liste des en-têtes de carte et les présente à l'utilisateur. Cliquez sur l'en-tête de la carte 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 cartes dans votre module complémentaire.
Lorsque vous concevez des modules complémentaires, il est préférable de limiter le nombre de cartes que vous affichez à la fois, car les cartes doivent partager une quantité limitée d'espace à l'écran. Il est également préférable d'éviter toute complexité inutile dans les cartes.
Pour des raisons de performances, vous ne pouvez pas ajouter plus de 100 widgets ni 100 sections de carte à une carte.