> Mis à jour pour la version 6.0.30

Deux types de variables servent à afficher une progression ou une attente : **Pourcentage** (un nombre de 0 à 100, comme une barre de vie) et **Durée** (un temps en secondes, comme un délai ou un chronomètre). Chacun a son panneau visuel pour régler la valeur, et ils se branchent partout où un nombre est attendu, y compris dans une **Jauge simple** de menu.

![Fenêtre Variables du projet avec la variable Pourcentage « jauge » sélectionnée et son panneau à droite (0 %, Faible, valeurs rapides)](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUFKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--bcf94e9387d5931b437a79dc7c763d7955ecc3a9/translation-variables--variable-panneau-pourcentage.fr.png)
*Le navigateur de variables avec une variable Pourcentage sélectionnée, le panneau de la jauge à droite*

## À quoi ça sert

| Type | Valeur | Exemples d'usage |
|---|---|---|
| Pourcentage | Un nombre de 0 à 100 | Barre de vie, progression d'une formation, taux de réussite |
| Durée | Un temps en secondes (jamais négatif) | Délai d'attente, temps imparti, chronomètre |

Un **Nombre** ordinaire n'a pas de bornes. Un **Pourcentage** reste entre 0 et 100, et une **Durée** reste positive : c'est ce qui les rend plus sûrs pour une jauge ou un minuteur.

## Où trouver ces types

1. Ouvrez la liste des variables et cliquez sur **Ajouter variable**.
2. Donnez un nom, puis ouvrez le menu **Type de la variable (ne peut pas être changé)**.
3. Choisissez **Pourcentage** (« Un nombre de 0 à 100, comme une jauge de santé ou un taux de réussite ») ou **Durée** (« Un temps en secondes, comme un chronomètre ou un délai d'attente »).
4. Cliquez sur **Ajouter**.

> ⚠ **Attention :** le type d'une variable ne peut pas être changé après sa création. Si vous vous trompez, créez une nouvelle variable.

Le panneau visuel règle la **valeur initiale**, c'est-à-dire la valeur de départ au lancement du graphe. Tant que la variable n'a pas de valeur, le panneau propose de la créer (**Ajouter un pourcentage** ou **Ajouter une durée**).

## Pourcentage

![Le panneau Pourcentage avec la valeur en grand, le niveau, la jauge, les valeurs rapides et le champ](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBck1KIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d5863e971ee7002e5274b0cb5086bc6a1c79ce14/aide-visuels--variable-panneau-pourcentage-complet.fr.png)
*Le panneau Pourcentage avec la valeur en grand, le niveau, la jauge, les valeurs rapides et le champ.*

Le panneau affiche la valeur en grand (par exemple « 50 % ») avec un niveau : **Faible** sous 25, **Moyen** de 25 à moins de 75, **Élevé** à partir de 75. Une phrase rappelle l'état : « En ce moment, Vie est à 50 %. »

Pour changer la valeur :

- cliquez sur la **jauge**, ou faites-la glisser ;
- cliquez sur une **valeur rapide** : 0, 25, 50, 75 ou 100 ;
- tapez un nombre dans le champ, ou utilisez les boutons **Diminuer** et **Augmenter** (un pas de 1 par défaut, 10 en maintenant **Maj**).

Les flèches du clavier fonctionnent sur la jauge (touches **Début** et **Fin** pour aller à 0 et à 100) et dans le champ. Une valeur hors de la plage est ramenée à 0 ou à 100. Si le champ est vide, la variable garde sa valeur précédente jusqu'à ce que vous tapiez un nombre.

## Durée

![Panneau Durée : « 1 min 30 s », total en secondes, champs Jours, Heures, Minutes, Secondes et durées courantes](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUVKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1dc325cde5c19b74ae8c00593c63e353d628d779/translation-variables--variable-panneau-duree.fr.png)
*Le panneau Durée avec les champs Jours, Heures, Minutes, Secondes et les durées courantes*

Le panneau affiche la durée lisible (« 1 min 30 s »), son total en secondes et quatre champs : **Jours**, **Heures**, **Minutes**, **Secondes**. Les secondes acceptent des décimales, jusqu'à la milliseconde. Les quatre champs s'additionnent : 90 secondes et 1 minute 30 secondes sont la même durée, et le panneau les réécrit sous la forme la plus courte.

Sous les champs, **Durées courantes** propose cinq boutons : 5 s, 30 s, 1 min, 5 min et 1 h. Les boutons plus et moins de chaque champ changent la valeur de 1 (de 10 en maintenant **Maj**).

Une durée ne peut pas être négative : une valeur négative n'est pas gardée et le panneau le dit (« Une durée ne peut pas être négative, cette valeur n'a donc pas été gardée »). Le maximum est de 10 000 jours.

## Utiliser ces variables dans les blocs

Pourcentage et Durée appartiennent à la famille des nombres : ils se branchent là où un **Nombre** est attendu, et un Nombre se branche là où ils sont attendus.

- Les blocs **Incrémentation**, **Décrémentation** et **Assignation** peuvent les modifier.
- Une **Durée** se branche sur les entrées qui lisent un nombre, par exemple la **Durée** du bloc **Pause**, le minuteur d'un bloc **QTE** ou le délai d'une **Notification**.
- Un **Pourcentage** se branche sur les opérandes d'une **Expression** et dans les emplacements d'un bloc **Formater texte**. Il ne se branche pas directement sur une entrée **Booléen** ou **Texte** : passez par une **Expression**.
- Quand un bloc écrit un nombre dans une variable Pourcentage pendant l'exécution, le résultat est ramené entre 0 et 100. Un Pourcentage écrit dans une variable Nombre devient un simple nombre.
- Une Durée ne peut pas servir d'élément dans une liste ; un Pourcentage le peut.

Pour les calculs, lisez [➗ Opérations mathématiques](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-operations-mathematiques-5613cf), et pour comparer des valeurs [🔢 Mettre en place des conditions numériques](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-mettre-en-place-des-conditions-numeriques-5f5d6b).

## Une jauge de menu pilotée par une variable

L'élément de menu **Jauge simple** affiche une barre de progression (une option **PRO**).

1. Dans l'éditeur de menu, cliquez sur **Ajouter un élément**.
2. Dans **Choisir l'élément à ajouter**, choisissez **Jauge simple**.
3. Dans **Variable**, choisissez la variable à afficher, par exemple un Pourcentage.
4. Réglez **Minimum** et **Maximum**.
5. Ajustez **Apparence**, **Couleur**, **Afficher la valeur** et **Apparence du texte**.

![Éditeur d'une Jauge simple de menu avec les champs Variable, Minimum et Maximum](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUlKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a7a16f114617fc702820a902a166e6cbbb5e606e/menu-elements--jauge-simple-edition.fr.png)
*L'éditeur de la Jauge simple avec les champs Variable, Minimum et Maximum*

Les bornes **Minimum** et **Maximum** valent 0 et 100 par défaut, ce qui convient tel quel à un Pourcentage. Chaque borne peut être un nombre fixe ou une variable de la famille Nombre : dès qu'une variable est liée, le champ numérique disparaît. La jauge suit alors la valeur de cette variable. Ainsi, un maximum lié à une Durée « Temps imparti » adapte la jauge à chaque épreuve.

À savoir sur le comportement :

- si la variable d'une borne a été supprimée, la jauge reprend le nombre fixe ;
- si le maximum est égal au minimum, la jauge est vide ; gardez un maximum supérieur au minimum ;
- sans variable liée, la jauge s'affiche à moitié ;
- avec **Afficher la valeur**, le texte montre la valeur brute (60, et non 60 %).

## Exemples

**Une barre de vie.** Créez un Pourcentage « Vie » à 100. Ajoutez une **Jauge simple** liée à « Vie », avec **Minimum** 0 et **Maximum** 100. Un bloc **Décrémentation** retire des points à chaque coup reçu, et la jauge descend avec lui. La valeur ne passe pas sous 0 : pendant la partie, un Pourcentage est toujours ramené entre 0 et 100.

**Un temps imparti.** Créez une Durée « Temps imparti » à 30 s avec le bouton de durée courante, puis branchez-la sur la **Durée** d'un bloc **Pause** ou sur le minuteur d'un bloc **QTE**.

## Dépannage

| Symptôme | Solution |
|---|---|
| Je ne peux pas changer le type de ma variable | Le type est définitif : créez une nouvelle variable du bon type |
| Ma valeur reste à 100 alors que j'ai tapé plus | Un Pourcentage est borné à 100 : la valeur est ramenée à la limite |
| La valeur négative est refusée | Une Durée n'est jamais négative : tapez 0 ou un nombre positif |
| Mon champ vide ne change rien | La variable garde sa valeur tant qu'aucun nombre n'est tapé |
| Ma jauge est vide | Vérifiez que le maximum est supérieur au minimum |
| Je ne trouve pas la Jauge simple | C'est un élément PRO : il demande un abonnement qui l'inclut |

## Voir aussi

- [Choisir le type d'une variable](https://documentation.celestory.io/hc/celestorydoc/articles/1795347773-choisir-le-type-d-une-variable)
- [➗ Opérations mathématiques](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-operations-mathematiques-5613cf)
- [🔢 Mettre en place des conditions numériques](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-mettre-en-place-des-conditions-numeriques-5f5d6b)
- [💬 Personnaliser un texte/score](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-personnaliser-un-texte-score-f24d00)
