Les modules complémentaires Google Workspace doivent être cohérents avec le style et la mise en page de l'application hôte qu'ils étendent. Ils doivent étendre l'interface utilisateur de manière naturelle en utilisant des commandes et des comportements familiers. Les consignes présentées ici décrivent comment gérer le texte, les images, les commandes et le branding pour offrir une expérience utilisateur de haute qualité.
Si votre module complémentaire ouvre des pages Web distinctes qui font partie intégrante de son fonctionnement (comme une page de paramètres), assurez-vous que ces pages Web respectent également ces consignes de style.
Texte et images
Cette section explique comment utiliser du texte et des images dans votre module complémentaire.
Nom du module complémentaire
Vous devez définir le nom de votre module complémentaire dans son fichier manifeste de projet et lorsque vous le configurez pour la publication. Le nom apparaît à de nombreux endroits, par exemple dans la fiche Google Workspace Marketplace et dans les menus. Lorsque vous choisissez un nom :
- Mettez une majuscule au début de chaque mot.
- Évitez la ponctuation, en particulier les parenthèses, sauf si elle fait partie de votre marque.
- Choisissez un nom court (15 caractères ou moins). Les noms longs peuvent être tronqués automatiquement dans la fiche Google Workspace Marketplace et ailleurs.
- N'incluez pas les mots "Google", "Gmail" ni d'autres noms de produits Google dans le nom de votre module complémentaire.
- N'incluez pas le mot "module complémentaire" dans le nom de votre module complémentaire.
- Ne mentionnez pas les informations sur la version.
Style de rédaction
Vous ne devriez pas avoir besoin d'écrire beaucoup. La plupart des actions doivent être claires grâce à l'iconographie, à la mise en page et à des libellés courts. Si vous constatez qu'une partie de votre module complémentaire nécessite une explication plus détaillée que celle fournie par des libellés courts, il est recommandé de créer une page Web distincte décrivant votre module complémentaire et d'y ajouter un lien.
Lorsque vous rédigez du texte pour l'interface utilisateur :
- Seule la première lettre doit être en majuscule (en particulier pour les boutons, les libellés et les actions liées aux cartes).
- Privilégiez un texte court et clair, sans jargon ni acronyme.
Actions universelles et actions liées aux cartes
Si vous utilisez des actions universelles ou des actions liées aux cartes dans votre module complémentaire, elles apparaissent sous forme d'éléments de menu dans les cartes que vous définissez. Vous pouvez choisir le texte à utiliser dans ces menus pour ces actions. Lorsque vous choisissez le texte à utiliser :
- Évitez le texte de menu qui répète le nom de votre module complémentaire.
- Commencez chaque élément de menu par un verbe d'action tel que "Exécuter", "Configurer" ou "Créer".
- Décrivez la tâche, et non le composant d'interface utilisateur affiché par l'action.
- Si votre action lance un workflow et qu'il n'existe pas de verbe unique pour la décrire, appelez-la "Démarrer".
- Limitez le nombre d'éléments de menu pour éviter que l'utilisateur n'ait à faire défiler une longue liste. Si vous avez d'autres actions à implémenter, envisagez d'utiliser plusieurs cartes avec des actions différentes sur chacune d'elles.
Messages d'erreur
En cas de problème, il est important d'utiliser un langage simple. Expliquez le problème du point de vue de l'utilisateur et suggérez comment le résoudre.
- Ne laissez pas l'utilisateur voir les exceptions générées par votre code. Utilisez plutôt des instructions
try...catchpour intercepter les exceptions, puis affichez un message d'erreur convivial. - Avant de publier, vérifiez que votre module complémentaire n'affiche pas d'informations de débogage dans l'interface utilisateur.
Les contenus d'aide
Vous pouvez ou devez concevoir des cartes qui affichent des informations d'aide ou expliquent le fonctionnement du module complémentaire à l'utilisateur. Si vous créez du contenu d'aide pour votre module complémentaire, n'oubliez pas de :
- Si possible, affichez les instructions dans une liste à puces ou numérotée. Guidez les utilisateurs jusqu'au résultat final, avec des références claires aux éléments d'interface utilisateur nommés.
- Assurez-vous que vos instructions expliquent clairement toutes les exigences, comme la configuration d'une feuille de calcul d'une certaine manière.
- N'hésitez pas à ajouter des liens vers du contenu d'aide externe, comme des pages Web d'assistance.
Images
Les images utilisées dans votre module complémentaire sont l'un des types d'icônes intégrés ou une image hébergée publiquement spécifiée par une URL. Lorsque vous utilisez des images hébergées, assurez-vous qu'elles sont accessibles à tous ceux qui peuvent utiliser votre module complémentaire.
Commandes
Cette section fournit des consignes sur l'expérience utilisateur pour les widgets interactifs.
Boutons
Utilisez des boutons pour contrôler les actions principales de votre interface utilisateur plutôt que d'autres widgets.
- La plupart des libellés de boutons de texte doivent commencer par un verbe.
- Dans la plupart des cas, les lignes de boutons ne doivent pas comporter plus de trois boutons.
DecoratedText
Les widgets DecoratedText vous permettent de présenter du contenu textuel avec des icônes, des boutons ou des commutateurs.
- Seule la première lettre doit être en majuscule pour le contenu textuel.
- Le texte d'un widget DecoratedText est tronqué s'il ne peut pas tenir dans l'espace disponible. Pour cette raison, essayez toujours de limiter au maximum le contenu textuel.
Entrées de sélection
Vous pouvez utiliser différents widgets d'entrée de sélection dans votre module complémentaire : des zones de sélection déroulantes, des cases à cocher, et des cases d'option.
- Utilisez des cases à cocher lorsque les utilisateurs peuvent sélectionner plusieurs options ou aucune option. Utilisez des cases d'option (ou un menu de sélection) lorsqu'une seule option doit être sélectionnée. Utilisez des listes déroulantes lorsque vous fournissez une courte liste d'alternatives tout en essayant de gagner de la place dans l'interface utilisateur.
- Seule la première lettre doit être en majuscule pour le texte attribué à chaque option.
- Évitez d'utiliser les modifications de sélection pour déclencher des actions majeures et difficiles à annuler, car les utilisateurs font souvent des erreurs lorsqu'ils effectuent des sélections. Envisagez plutôt d'ajouter un bouton qui lit les valeurs de sélection actuelles, puis déclenche l'action.
- Pour les listes déroulantes, triez les options par ordre alphabétique ou selon un schéma logique que tous les utilisateurs peuvent comprendre (par exemple, en présentant les jours de la semaine dans l'ordre, en commençant par le dimanche ou le lundi).
- Limitez le nombre d'options dans un widget d'entrée de sélection donné à un nombre raisonnable. Si le nombre d'options est trop élevé, les utilisateurs peuvent avoir du mal à utiliser le widget. Dans ce cas, envisagez de diviser l'option en différentes catégories et en plusieurs widgets.
Saisies de texte
Les saisies de texte permettent aux utilisateurs de saisir des données de chaîne.
- N'utilisez pas de saisie de texte pour que l'utilisateur saisisse l'une des entrées possibles d'un ensemble spécifique. Utilisez plutôt une sélection déroulante.
- Utilisez des conseils et des suggestions pour aider l'utilisateur à saisir du texte au format et avec le contenu appropriés.
- Utilisez des saisies de texte multilignes si le texte à saisir comporte plus de quelques mots.
Branding
Cette section fournit des consignes sur l'expérience utilisateur pour ajouter des éléments de branding à l'interface de votre module complémentaire.
Dans votre module complémentaire
Si vous souhaitez inclure le branding dans l'interface utilisateur de votre module complémentaire, faites-le de manière brève et légère. Cela permet aux utilisateurs de se concentrer sur les fonctionnalités de votre module complémentaire.
- Tous les aspects de votre module complémentaire doivent respecter les consignes relatives au branding.
- N'incluez pas les mots "Google", "Gmail" ni d'autres noms de produits Google.
- N'incluez pas d'icônes de produits Google, même si elles sont modifiées.
- N'incluez pas le mot "module complémentaire" dans le texte de votre branding.
- Le texte de branding ne doit pas comporter plus de quelques mots.
Dans Google Workspace Marketplace
Lorsque vous configurez votre module complémentaire pour la publication, vous fournissez un certain nombre d'éléments graphiques et textuels pour créer la fiche Google Workspace Marketplace.
Tous les aspects de votre fiche Play Store et de ces éléments doivent respecter les consignes relatives au branding.