# Valeur

> L'affichage en direct mis en forme : un point écrit avec son unité, ses décimales, une largeur de champ déclarée et des plages de sens facultatives.

**Valeur** est l'affichage de base : il écrit un point de l'espace d'adressage en direct dans sa
cellule, mis en forme comme vous le déclarez. La lecture prend toute la cellule ; une légende pour
elle est un [Libellé](component-label) que vous posez à côté, ou le titre de coin propre au
composant, dans la section Apparence partagée. C'est un composant *Affichage* ; un nouveau occupe
4 × 2 cellules.

Une Valeur ne montre jamais un nombre périmé. Un point qui n'arrive pas à lire dessine le tiret de
lacune (`—`) dans l'encre secondaire discrète, et le composant porte la marque de lecture mauvaise
partagée, décrite sur la
[page des composants](components#addresses-and-live-readings). Un point qui répond en bonne qualité
mais ne contient aucune valeur en ce moment (un banc entre deux essais, un compteur hors cycle)
dessine le même tiret *sans* la marque : ce silence est normal, pas un échec.

## Données {#data}

| Champ | Ce qu'il fait | Valeurs | Par défaut |
|---|---|---|---|
| Adresse | L'adresse Logic enracinée du point affiché. La liste propose des points en direct de toutes les catégories de valeur : un affichage met en forme ce que le point contient, un nombre, un texte, un drapeau, un instant. | Texte libre ; propositions issues de la liste de points en direct | vide |

Sous le champ, l'éditeur montre ce que le point choisi lit en ce moment, de sorte que la liaison se
confirme elle-même avant même que la vue s'exécute.

## Mise en forme {#format}

| Champ | Ce qu'il fait | Valeurs | Par défaut |
|---|---|---|---|
| Unité | Suffixe d'unité écrit à côté de la valeur, en plus petit, dans l'encre secondaire. Il fait partie de la largeur de champ réservée, donc il ne passe jamais à la ligne. Masqué tant que le point ne lit pas. | Texte libre | vide |
| Décimales | Nombre fixe de décimales pour les lectures numériques. Vide suit la préférence décimale de la station (voir la [page Paramètres](settings-localization)), et un point dont le type est un nombre entier s'écrit alors sans fraction. Les saisies hors de la plage sont prises au bord le plus proche, et le volet le dit. Les formats horloge et mots n'écrivent aucune fraction, donc le nombre n'y est pas lu. | de 0 à 15, ou vide | vide (préférence de la station) |
| Chiffres / Caractères | Ce que le champ contient, la déclaration derrière le contrat d'affichage d'une valeur. En **Chiffres** (formats numériques) : les places avant le séparateur décimal ; une lecture qui en demande plus est *signalée*, jamais écrite en abrégé. En **Caractères** (le format Texte) : combien de caractères la ligne contient ; une lecture plus longue est écrite en abrégé avec des points de suspension. Le champ est nommé d'après la mesure que le format choisi déclare. | Chiffres : de 1 à 20 · Caractères : de 1 à 40, ou vide | 5 chiffres · 12 caractères |
| Taille du texte | Si la cellule décide de la taille du texte ou si vous la fixez. | `Aussi grand que la cellule le permet` · `Une taille que je fixe` | `Aussi grand que la cellule le permet` |
| Taille (points) | La taille de texte fixée. Montrée seulement dans le mode fixé. Une taille fixée est littérale : elle s'affiche à cette taille dans n'importe quelle cellule et n'est jamais réduite pour faire entrer la lecture ; ce qui n'entre plus est signalé, pas réduit. | de 9 à 144 points | 12 |
| S'affiche comme | Comment la lecture est écrite. | `Nombre` · `Pourcentage` · `Durée` · `Texte` | `Nombre` |
| La valeur compte en | Ce qu'une unité de la valeur signifie tant que **S'affiche comme** vaut `Durée`. Le temps écoulé arrive comme un nombre nu, et le même nombre est des millisecondes sur un point et des minutes sur un autre, donc le composant dit lequel. Montré seulement pour le format durée. | `Secondes` · `Millisecondes` · `Minutes` | `Secondes` |

### Les quatre formats {#the-four-formats}

- **Nombre** écrit le nombre physique sur la préférence décimale de la station, ou sur les
  **Décimales** explicites. Un nombre entier sans décimales déclarées s'écrit sans fraction,
  avec chacun des chiffres qu'il porte, aussi grand soit-il.
- **Pourcentage** écrit le même nombre suivi de `%`. La valeur n'est *pas* remise à l'échelle : le
  point est déjà un pourcentage ; le calcul de la chaîne de conversion reste dans les étapes de
  conversion du Connector.
- **Durée** écrit une horloge : `hh:mm:ss`, ou `d.hh:mm:ss` à partir d'un jour. Un compte négatif
  garde son signe. C'est la même horloge que celle des occurrences d'un essai, des lignes
  d'Historiques et du rapport PDF.
- **Texte** écrit les mots dans lesquels le point répond, un ordre, un lot, le nom d'un profil,
  exactement comme ils viennent. Le choisir est aussi la déclaration que la largeur du champ compte
  des **caractères** au lieu de chiffres, ce qui change le nom du champ de largeur, sa valeur par
  défaut et sa conduite (points de suspension au lieu de la marque de dépassement).

Nombre, Pourcentage et Durée disent comment s'écrit un *nombre*, et c'est le type du point qui
décide si la lecture en est un, comme partout ailleurs sur la station. Une lecture qui n'est pas
du tout un nombre (un drapeau, un texte, un instant) a tout de même répondu, donc elle est
écrite telle qu'elle est plutôt que remplacée par une lacune, quel que soit celui des trois qui
est choisi : un drapeau s'affiche `true` ou `false`, jamais comme un nombre à décimales, un
pourcentage ou une horloge. `NaN` est aussi une lecture : il s'écrit avec ce mot, à côté de son
unité, et jamais avec le tiret de lacune.

## Comment la lecture est dessinée {#how-the-reading-is-drawn}

La taille du texte ne suit jamais la valeur. En mode automatique, la cellule décide de la taille,
bornée par la largeur que la déclaration réserve (chiffres + séparateur + décimales + unité, ou les
caractères déclarés) ; dans le mode fixé, la taille est exactement les points que vous avez tapés.
Deux cellules de même taille portant les mêmes déclarations sortent toujours à la même taille, et
une valeur qui oscille entre quatre et six caractères ne bouge jamais la typographie.

Ce qui se passe quand le contenu dépasse sa déclaration :

| Situation | Ce que la cellule montre |
|---|---|
| Un nombre demande plus de chiffres que déclaré | La marque de dépassement `####`, avec la lecture entière (unité comprise) dans l'infobulle. La marque signifie exactement une chose : ce champ ne peut pas contenir ce nombre. |
| Une taille fixée demande plus de largeur que la cellule n'en a | La même marque `####` : une taille littérale n'est jamais réduite. Sous une taille fixée, l'infobulle porte toujours la lecture entière. |
| Une lecture Texte est plus longue que les caractères déclarés | Tronquée par des points de suspension, texte entier dans l'infobulle. Les mots ne portent jamais la marque du nombre. |
| Une lecture en mots est plus longue que le champ alors que la Valeur s'affiche comme Nombre, Pourcentage ou Durée | Tronquée par des points de suspension, avec la lecture entière (unité comprise) dans l'infobulle. Les mots ne portent jamais la marque du nombre, pas même quand ils ne sont faits que de chiffres. |
| Le point ne lit pas | Le tiret de lacune `—`. L'absence de lecture et l'absence de place n'empruntent jamais la marque l'une de l'autre. |

Les nombres se posent à droite de leur champ en chiffres tabulaires, de sorte qu'une colonne de
composants Valeur s'aligne avec elle-même et que le séparateur garde sa place à mesure que la partie
entière grandit.

## Échelle {#scale}

La déclaration de plages facultative que partagent les genres qui affichent une lecture : chaque
plage couvre la plage de la valeur jusqu'à sa borne, en partant de là où la plage du dessus dans la
liste s'est arrêtée, et une lecture au-delà de la dernière borne n'appartient à aucune plage. Les
plages *teintent* le nombre avec les tons de sens propres à l'interface ; une lecture qu'aucune
plage ne revendique garde l'encre habituelle.

| Champ | Ce qu'il fait | Valeurs | Par défaut |
|---|---|---|---|
| jusqu'à | Où la plage finit (borne comprise), dans l'unité physique du point. Une nouvelle plage démarre avec le champ vide, et une borne vide n'est pas zéro : la plage ne revendique rien et ne teinte rien tant qu'une borne n'est pas tapée. | N'importe quel nombre | vide |
| Sens de la plage | Ce qu'une lecture à l'intérieur de la plage signifie. Le ton nomme le sens ; le thème en cours décide de la teinte. | `Neutre` · `Informatif` · `Succès` · `Prudence` · `Critique` | `Neutre` |
| nomme cet état | Libellé facultatif de la plage (« Préchauffage », « Surpression »). Un libellé sur une plage quelconque ajoute une ligne d'état sous le nombre, qui écrit le mot de la plage en cours, dans le ton de la plage. | Texte libre | vide |

La ligne d'état n'existe que tant qu'au moins une plage porte un libellé. Elle garde sa hauteur tant
que rien n'est nommé, de sorte que le nombre au-dessus ne se redimensionne jamais quand une lecture
franchit une borne, et elle se tronque par des points de suspension avec le mot entier dans son
infobulle. Les flèches Monter et Descendre échangent le sens et le libellé d'une plage avec ceux de
sa voisine tout en laissant en place les bornes tapées.

Valeur est un composant d'affichage : il ne commande rien, donc il ne porte jamais la marque de
verrou. Les sections partagées Apparence, Identification du composant, Position et couche et Actions
du composant sont décrites sur la [page des composants](components#the-shared-property-sections).