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. Il doit étendre l'UI 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 (par exemple, une page de paramètres), assurez-vous que ces pages Web respectent également ces consignes de style.
Texte et images
Cette section vous explique comment utiliser correctement le texte et les images dans votre module complémentaire.
Nom du module complémentaire
Vous devez définir le nom de votre module complémentaire dans le fichier manifeste de son projet et lorsque vous configurez votre module complémentaire pour la publication. Ce nom apparaît à de nombreux endroits, comme dans la fiche Google Workspace Marketplace et dans les menus. Lorsque vous choisissez un nom :
- Utilisez la casse de titre.
- Évitez la ponctuation, en particulier les parenthèses, sauf si elle fait partie de votre marque.
- Essayez de ne pas dépasser 15 caractères. 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.
- Omettez les informations sur la version.
Style de rédaction
Vous n'aurez pas besoin d'écrire beaucoup. La plupart des actions doivent être clairement indiquées par des icônes, une 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 les 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'UI :
- Utilisez la casse de phrase (en particulier pour les boutons, les libellés et les actions sur les cartes).
- Privilégiez un texte court et simple, sans jargon ni acronymes.
Actions universelles et actions sur les cartes
Si vous utilisez des actions universelles ou des actions de carte dans votre module complémentaire, elles s'affichent sous forme d'éléments de menu dans les cartes que vous définissez. Vous pouvez choisir le texte utilisé dans ces menus pour ces actions. Lorsque vous choisissez le texte à utiliser :
- Évitez de répéter simplement le nom de votre module complémentaire dans le texte du menu.
- 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'UI que l'action affiche.
- 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 de forcer l'utilisateur à faire défiler une longue liste. Si vous avez d'autres actions à implémenter, envisagez d'utiliser plusieurs cartes avec différentes actions sur chacune d'elles.
Messages d'erreur
En cas de problème, il est important d'utiliser un langage simple. Explique le problème du point de vue de l'utilisateur et suggère comment le résoudre.
- N'autorisez 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 votre module complémentaire, vérifiez qu'il n'affiche pas d'informations de débogage dans l'UI.
Les contenus d'aide
Vous pouvez 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, présentez les instructions sous forme de liste à puces ou numérotée. Guidez les utilisateurs jusqu'au résultat final, en faisant clairement référence aux éléments d'interface utilisateur nommés.
- Assurez-vous que vos instructions expliquent clairement les exigences, par exemple la configuration d'une feuille de calcul d'une certaine manière.
- N'hésitez pas à inclure des liens vers des contenus d'aide externes, comme des pages Web d'assistance.
Images
Les images utilisées dans votre module complémentaire sont soit l'un des types d'icônes intégrés, soit une image hébergée publiquement et spécifiée par une URL. Lorsque vous utilisez des images hébergées, assurez-vous qu'elles sont accessibles à tous les utilisateurs potentiels de 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 du titre doit être en majuscule.
- Le texte d'un widget DecoratedText est tronqué s'il ne tient pas dans l'espace disponible. C'est pourquoi vous devez toujours essayer de garder le contenu textuel aussi court que possible.
Entrées de sélection
Vous pouvez utiliser différents widgets de saisie de sélection dans votre module complémentaire : des zones de sélection déroulantes, des cases à cocher et des boutons radio.
- Utilisez des cases à cocher lorsque les utilisateurs peuvent sélectionner plusieurs options ou aucune. Utilisez des cases d'option (ou un menu de sélection) lorsqu'une seule option doit être sélectionnée. Utilisez des menus déroulants lorsque vous fournissez une courte liste d'alternatives tout en essayant de gagner de la place dans l'UI.
- Utilisez la casse de phrase 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 menus déroulants, 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 de saisie de sélection donné à un nombre raisonnable. Si le widget propose trop d'options, les utilisateurs peuvent avoir du mal à l'utiliser. Dans ce cas, envisagez de diviser l'option en différentes catégories et en plusieurs widgets.
Saisies de texte
Les entrées de texte permettent aux utilisateurs de saisir des données de type 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 de menu déroulant.
- Utilisez des indices et des suggestions pour aider l'utilisateur à saisir du texte au format et au contenu corrects.
- Utilisez des entrées 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 une marque dans l'interface utilisateur de votre module complémentaire, veillez à ce qu'elle soit 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 à l'image de marque.
- N'incluez pas le mot "Google", "Gmail" ni d'autres noms de produits Google.
- N'incluez pas d'icônes de produits Google, même si elles ont été modifiées.
- N'incluez pas le mot "module complémentaire" dans le texte de votre marque.
- 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 de composants graphiques et textuels pour créer la fiche Google Workspace Marketplace.
Tous les aspects de votre fiche Play Store et de ces composants doivent respecter les Consignes relatives à la marque.