# Progression

> Référence du composant de tableau de bord Progression : une lecture bornée en barre, en bargraphe ou sur une échelle par plages, avec toutes ses propriétés d'éditeur.

Le composant **Progression** dessine une lecture numérique bornée le long d'une barre. Ses trois
présentations répondent à des questions différentes sur la même valeur, quelle part de la plage est
prise, combien de pas en sont pris, et dans quelle portion déclarée la lecture se trouve, et c'est
pour cela qu'elles sont un choix et non un style. Une barre sans lecture ne dessine aucun
remplissage du tout (remplie à vide, elle se lirait comme un zéro mesuré) et montre la marque de
lacune (`—`) là où va le nombre. `NaN` est une lecture, pas une lacune : ce mot s'écrit à côté de son
unité et la barre reste vide, puisque `NaN` n'a pas de place sur l'échelle.

## Contenu et données {#content-and-data}

| Propriété | Ce qu'elle fait | Valeurs | Par défaut |
|---|---|---|---|
| Libellé | Légende facultative au-dessus de la barre. Un libellé long est tronqué avec le tout dans l'infobulle et ne prend jamais de place à la lecture. | texte | vide |
| Adresse | Adresse Logic enracinée du point numérique montré. Le champ propose depuis la liste des points en direct, filtrée sur les points numériques, et montre la lecture actuelle du point une fois qu'il est nommé. | adresse | vide |

## Mise en forme {#format}

| Propriété | Ce qu'elle fait | Valeurs | Par défaut |
|---|---|---|---|
| Mini | Là où l'échelle commence, dans l'unité physique du point. | nombre | 0 |
| Maxi | Là où l'échelle finit. Sous Mini, il n'y a plus d'échelle sur laquelle placer une lecture. | nombre | 100 |
| Unité | Suffixe d'unité facultatif à côté de la lecture. | texte | vide |
| Décimales | Nombre fixe de décimales pour la lecture. Laissé vide, un point dont le type est un nombre entier s'écrit sans fraction, et tout autre nombre aux décimales de la station ; les extrémités de l'échelle et la référence suivent les décimales du point comme la lecture (aucune sur un nombre entier, celles de la station sur un réel). | de 0 à 15 | vide suit la préférence de la station |
| Chiffres | Combien de places la lecture réserve avant le séparateur décimal ; une lecture qui dépasse est signalée (`####`) avec le tout dans l'infobulle. Un point qui répond en mots (un ordre, un lot, un drapeau) ne porte jamais la marque, pas même quand ses mots ne sont faits que de chiffres : ce que le champ ne peut pas contenir se termine par des points de suspension (…), avec la lecture entière dans l'infobulle. | de 1 à 20 | vide le dérive du plus large de Mini et Maxi |
| Taille du texte | Si la cellule décide de la taille du texte ou si l'opérateur la fixe. | Aussi grand que la cellule le permet · Une taille que je fixe | Aussi grand que la cellule le permet |
| Taille (points) | La taille fixée. Montrée seulement dans le mode fixé. | de 9 à 144 | 12 |
| S'affiche comme | Comment la lecture est écrite. | Nombre · Pourcentage · Durée | Nombre |
| La valeur compte en | Ce que vaut une unité de la valeur tant que la mise en forme est une durée. | Secondes · Millisecondes · Minutes | Secondes |
| Écrire la lecture | Si la lecture est écrite à côté de la barre. | activé / désactivé | activé |
| Écrire les extrémités de l'échelle | Si les deux extrémités sont écrites sous la barre. | activé / désactivé | désactivé |

## Barre {#track}

| Propriété | Ce qu'elle fait | Valeurs | Par défaut |
|---|---|---|---|
| Trace | La présentation : un remplissage continu depuis le début de l'échelle jusqu'à la lecture ; le même remplissage découpé en cellules égales allumées jusqu'à la lecture (un bargraphe) ; ou les plages déclarées peintes le long de la barre, la lecture les chevauchant sous forme de repère, sans que rien ne se remplisse, parce que la question est où la valeur se situe sur l'échelle, et non quelle part en est utilisée. | Une barre remplie jusqu'à la lecture · Des cellules allumées jusqu'à la lecture · Les plages, avec la lecture repérée dessus | Une barre remplie jusqu'à la lecture |
| Sens | Dans quel sens la barre court : en largeur dans la cellule, l'échelle commençant au bord gauche, ou en hauteur dans la cellule, l'échelle commençant en bas, une colonne de niveau. | En largeur dans la cellule · En hauteur dans la cellule | En largeur dans la cellule |
| Cellules | En combien de cellules une barre à pas est découpée. Demandé seulement par cette présentation. | de 2 à 50 | 10 |
| L'échelle démarre à l'extrémité opposée | Inverse le sens de l'échelle, si bien que le remplissage grandit vers l'extrémité proche. C'est le sens seulement, jamais une deuxième paire d'extrémités : Mini reste le minimum. | activé / désactivé | désactivé |
| Teinte d'accent | D'où vient la couleur du remplissage. Une identité, pas un sens : les plages gardent le dernier mot sur le sens de la lecture. | L'encre habituelle · Une couleur · Un point de couleur | L'encre habituelle |
| Clair / Sombre | L'accent sous forme de paire claire et sombre, les deux fixées parce que le thème en cours décide quelle moitié est à l'écran. Montré seulement tant que l'accent est une couleur. | `#RRGGBB` chacune | `#5470C6` les deux |
| Point de couleur | Adresse Logic enracinée d'un point Couleur que l'accent suit. Montré seulement tant que l'accent vaut `Un point de couleur`. | adresse | vide |

## Échelle {#scale}

La section **Échelle** partagée déclare les plages et la référence.

- Chaque **plage** couvre tout jusqu'à sa borne, depuis là où celle du dessus s'est arrêtée ; une
  lecture au-delà de la dernière borne n'appartient à aucune plage. Le sens (Neutre, Informatif,
  Succès, Prudence, Critique) teinte la lecture écrite, et sur la présentation par plages les plages
  sont la barre elle-même, peintes que le point réponde ou non : elles sont la déclaration, pas la
  mesure. Une plage libellée écrit son nom dans l'en-tête, avant le nombre, pour que la lecture garde
  la fin de la ligne.
- La **référence** marque une consigne ou une valeur nominale sur la barre : rien, une valeur fixe,
  ou un point qui se déplace avec la recette. L'infobulle du repère porte la valeur de la référence,
  et il n'est dessiné que tant que l'échelle l'atteint.