Complications
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une complication est un élément d'interface utilisateur qui se trouve sur un cadran et qui contient des informations lisibles que les utilisateurs souhaitent voir tout au long de la journée. Par exemple, vous pouvez créer une complication sur la météo actuelle ou sur la fréquence cardiaque.
Principes de l'expérience utilisateur
Les sections suivantes décrivent les principes à prendre en compte lors de la création de complications.
Lisibilité |
Efficacité de contenu |
Priorité à la confidentialité |
| Les complications sont de petits composants conçus pour aider les utilisateurs à effectuer rapidement des tâches fréquentes. Faites en sorte que le contenu soit simple et lisible. |
Les complications sont particulièrement utiles lorsque le contenu dont l'utilisateur a besoin est visible en levant simplement le poignet, sans qu'une action supplémentaire soit nécessaire. |
La montre accompagne l'utilisateur partout où il va. Réfléchissez à la pertinence du contenu des complications par rapport au contexte de l'utilisateur. |
Cas d'utilisation
Les complications peuvent aider les utilisateurs à accéder à une partie spécifique d'une application. Elles peuvent également effectuer des actions autonomes. Par exemple, en appuyant sur la complication "Eau bue", vous modifiez le nombre de verres bus.
Wear OS inclut automatiquement une complication de raccourci d'application. Vous n'avez donc pas besoin de créer la vôtre. Concentrez-vous plutôt sur la création de complications qui peuvent aider les utilisateurs à effectuer des tâches ciblées.
Types
Les types de complications font référence aux types de données présentés sur la complication ou fournis par une source de données. Une complication comporte toujours un type unique qui inclut des champs obligatoires et facultatifs. Un champ obligatoire contient les données principales. La plupart des types de complications tirent leur nom de leur champ obligatoire. Vous pouvez choisir le nombre de complications à inclure dans votre cadran et les types de complications à prendre en charge. Il existe cinq types de complications.
| Type |
Champs obligatoires |
Champs facultatifs |
Nom de classe. |
Exemple |
| SHORT_TEXT |
Texte court |
Icône
Icône de protection contre les brûlures d'écran
Titre court |
ShortTextComplicationData |
 |
| ICON |
Icône |
Icône de protection contre les brûlures d'écran |
MonochromaticImageComplicationData |
 |
| RANGED_VALUE |
Valeur
Valeur minimale
Valeur maximale |
Icône
Icône de protection contre les brûlures d'écran
Texte court
Titre court |
RangedValueComplicationData |
 |
| LONG_TEXT |
Texte long |
Titre long
Icône
Icône de protection contre les brûlures d'écran
Petite image |
LongTextComplicationData |
 |
| SMALL_IMAGE |
Petite image |
|
SmallImageComplicationData |
 |
| LARGE_IMAGE |
Grande image |
|
PhotoImageComplicationData |
 |
Pour en savoir plus sur les sources de données de complications, consultez Types de complications.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]
