For the complete documentation index, see llms.txt. This page is also available as Markdown.

Affichage beignet

Visualisez un relevé de capteur comme un anneau proportionnel avec l’affichage beignet dans le widget Dernières données — idéal pour les %.

Last Data widget using the Doughnut display type

L’affichage Doughnut représente la mesure sous forme d’anneau qui se remplit proportionnellement entre un minimum et un maximum que vous définissez, avec la valeur actuelle au centre. D’un coup d’œil, il répond à « où en est-on ? » — à un quart plein, presque au maximum — sans que personne ait besoin de lire le nombre.

Il convient à toute mesure qui se situe dans une plage connue : un niveau de remplissage, un pourcentage, une capacité, une valeur qui doit se trouver quelque part dans une bande de fonctionnement. Le remplissage de l’anneau rend sa position dans cette plage immédiate.

Quand le choisir

  • Une mesure avec une plage de fonctionnement définie où la proportion compte — capacité d’une cuve, charge de batterie, utilisation par rapport à une limite.

  • Une tuile de tableau de bord où un opérateur doit repérer d’un coup d’œil bas / moyen / élevé, sans interpréter des chiffres.

  • Partout où un pourcentage ou un ratio se lit plus clairement dans un anneau rempli que sous forme de chiffre.

Là où une mesure a un plancher et un plafond significatifs, le Doughnut la transforme en forme — laissez vos propres indicateurs suggérer où il se situe.

Configurer un affichage Doughnut

Voici une configuration complète pour un cas réel — un anneau qui affiche la température d’un bureau et indique si elle est confortable. Un capteur de température renvoie la pièce en °C. Une température n’est pas comme une cuve — elle n’a pas de « vide » ni de « plein » naturel, donc il n’y a pas de 0 et de 100 évidents. L’anneau a quand même besoin d’un plancher et d’un plafond, donc vous choisissez une plage assez large pour contenir toutes les températures que la pièce pourrait atteindre de manière réaliste : pour une pièce d’habitation, environ de -5 °C à +40 °C. C’est un exemple : un Doughnut convient à toute mesure que vous voulez voir comme une proportion d’une plage — seuls l’appareil et les nombres changent.

  1. Ouvrez le tableau de bord en mode édition et cliquez sur Dernières données dans le sélecteur de widgets. Le panneau des paramètres s’ouvre sur l’onglet Source de données onglet, sans encore aucune source de données.

  2. Cliquez sur Ajouter une source de données. Un Source de données 1 bloc apparaît.

  3. Dans le bloc, cliquez sur Choisir un appareil et sélectionnez le capteur de température.

  4. Cliquez sur Ajouter une métrique. Une ligne de métrique apparaît.

  5. Dans la ligne, définissez Type de données sur Télémétrie, choisissez la mesure de température sous Métrique de l’appareil, puis choisissez une Icône.

    Cet affichage a besoin d’un nombre. Le Métrique de l’appareil liste propose tous les types de métriques, mais une jauge se remplit sur une échelle — choisissez ici une mesure numérique ; une valeur textuelle non numérique est lue comme 0. (Pour afficher un texte ou une valeur marche/arrêt telle quelle, utilisez l’ affichage de valeur.) Pour modifier la manière dont une métrique est stockée, ouvrez Appareils → Métriques — voir Métriques.

  6. Cliquez sur Conditions : N pour ouvrir la fenêtre modale Conditions. Définissez une Couleur par défaut — la couleur à laquelle la mesure revient lorsque aucune de vos conditions ne correspond à la valeur actuelle — puis, pour chaque bande, cliquez sur Ajouter une condition et remplissez la ligne — saisissez un Nom de la condition, définissez Type de données sur Nombre (le type de données propre à la condition, et non la ligne de métrique), car une pièce d’habitation varie réalistement entre -5 °C et 40 °C, saisissez De -5 (la température la plus basse que vous attendriez) et À 40 (la plus élevée), et choisissez un Couleur. Vous pouvez ensuite saisir les niveaux de couleur. Par exemple :

    En partant de la température la plus froide :

    • "Trop froid" — De -5, À 15 — rouge

    • "Frais" — De 15, À 18 — jaune

    • "Confortable" — De 18, À 24 — vert

    • "Chaud" — De 24, À 28 — jaune

    • "Trop chaud" — De 28, À 40 — rouge

    Cliquez sur Enregistrer pour fermer la fenêtre modale.

  7. Cliquez sur Suivant pour ouvrir l’onglet Apparence .

  8. Saisissez un Nom du widget — par exemple « Température du bureau » — et une fenêtre facultative Description.

  9. Sous Type de widget, choisissez Doughnut. Un Plage de valeurs section apparaît pour la métrique.

  10. Définissez Valeur min sur -5 et Valeur max sur 40 — la fenêtre que vous avez choisie pour une pièce d’habitation. L’anneau se remplit pour montrer où se situe la température actuelle dans cette plage de -5 à 40 °C, et la condition dans laquelle tombe la mesure la colore.

  11. Activez Légende des données affichées si nécessaire, puis cliquez sur Enregistrer.

L’anneau affiche la température comme une position dans la plage choisie et devient vert uniquement dans la bande confortable. Les mêmes étapes conviennent à toute mesure avec un plancher et un plafond raisonnables — seuls l’appareil, la Valeur min/Valeur max, et les conditions changent. Un Doughnut mérite sa place lorsque la question est « où en est-on dans la plage ? » ; pour une température que l’on veut simplement lire, un Nombre ou une Jauge est souvent l’affichage le plus naturel.

Exemples pratiques

Le même capteur, une configuration complètement différente — un réfrigérateur Un réfrigérateur utilise le même type de capteur de température que le bureau ci-dessus, et pourtant chaque nombre est différent — parce que la bonne plage dépend de ce que vous mesurez. La bande de sécurité d’un réfrigérateur est d’environ 0 à 5 °C, donc vous réglez l’échelle un peu plus large que cette bande, afin qu’un réfrigérateur en panne qui se réchauffe reste visible sur l’anneau : Valeur min -5, Valeur max 15. Puis créez trois conditions : « Trop froid » — De -5 à 0 — bleu ; « Sûr » — De 0 à 5 — vert ; « Trop chaud » — De 5 à 15 — rouge. Matériel identique, étapes identiques — seules la plage et les bandes changent, parce que « bon » signifie quelque chose de complètement différent dans un réfrigérateur et dans un bureau. C’est là tout l’intérêt des conditions : vous décidez ce que chaque mesure signifie dans son propre contexte.

Un niveau de remplissage Un Doughnut convient naturellement à une cuve ou à une batterie. Un capteur de niveau dans une cuve de 5 000 litres indique le contenu en litres, donc 0 L correspond à une cuve vide et 5 000 L à une cuve pleine — Valeur min 0, Valeur max 5000 — avec des conditions vert De 3000 à 5000, jaune De 1000 à 3000, rouge De 0 à 1000. L’anneau se vide visiblement au fur et à mesure que la cuve se vide.

Voir aussi

Mis à jour