# Graphique en barres

> Référence du composant de tableau de bord Graphique en barres, la comparaison par catégories de points en direct, avec toutes ses propriétés d'éditeur.

Le **Graphique en barres** compare des points en direct côte à côte : une barre par adresse, lue à cet instant. C'est un graphique par catégories, pas un graphique temporel : il n'y a derrière lui ni axe du temps, ni fenêtre, ni cadence d'échantillonnage, ni conservation. Pour suivre des points dans le temps, employez le [Graphique en courbes](component-line-chart).

Un point qui ne lit pas est écarté de la comparaison au lieu d'être tracé à zéro, et le graphique le dit sous le dessin (`1 point sur 4 ne lit pas et il est écarté.`). Une vue qui vient tout juste de s'ouvrir ne dit rien encore : pas encore lu n'est pas la même chose que ne lit pas.

## Contenu et points {#content-and-points}

| Propriété | Ce qu'elle fait | Valeurs | Défaut |
|---|---|---|---|
| Titre du graphique | Intertitre facultatif dessiné à l'intérieur du sous-graphique. C'est l'intertitre propre au graphique, pas le titre de coin du composant (celui-là vit dans la section Apparence commune). | texte | vide |
| Points lus | Les catégories comparées, une carte par barre, dans l'ordre déclaré. Chaque carte porte les trois champs ci-dessous. **Ajouter un point** en ajoute une à la fin. | liste | vide |
| Adresse | L'adresse Logic enracinée que la barre lit. Le champ propose depuis la liste de points en direct, filtrée aux points numériques, et montre la lecture actuelle du point une fois qu'il est nommé. | adresse | vide |
| Nom | Ce que l'axe et la légende appellent la barre. | texte | vide retombe sur l'adresse |
| Couleur | L'encre de la barre en `#RRGGBB`. | couleur hexadécimale | vide prend le tour du nuancier |
| Ordre | L'ordre dans lequel les barres sont dessinées. L'ordre déclaré garde un poste là où l'opérateur l'a mis quoi qu'il ait produit; le tri répond plutôt à la question de savoir qui mène. | tel que déclaré · du plus petit au plus grand · du plus grand au plus petit | tel que déclaré |

## Mise en forme {#format}

Une seule déclaration pour tout le graphique, sur les barres, dans les infobulles et dans les étiquettes à la fois, parce qu'un graphique écrit un nombre d'une seule façon.

| Propriété | Ce qu'elle fait | Valeurs | Défaut |
|---|---|---|---|
| Unité | Unité physique facultative écrite après chaque lecture. | texte | vide |
| Décimales | Décimales fixes pour les lectures. | 0 à 15 | vide emploie la préférence de la station |
| S'affiche comme | La façon dont chaque lecture est écrite en toutes lettres. La valeur elle-même n'est jamais remise à l'échelle par le choix. | Nombre · Pourcentage · Durée | Nombre |
| La valeur compte en | Ce qu'une unité de la valeur veut dire tant que le format est une durée. Montré seulement pour ce format. | Secondes · Millisecondes · Minutes | Secondes |

## Barres {#bars}

| Propriété | Ce qu'elle fait | Valeurs | Défaut |
|---|---|---|---|
| Coucher les barres sur le côté | Dessine les barres à l'horizontale. Les noms longs se lisent mieux en travers que sous une barre. Quand la cellule est trop étroite pour les noms, les lectures et l'échelle côte à côte, elle cède de la place dans cet ordre : un nom plus long que sa part de la largeur se termine par des points de suspension, puis les lectures sont omises, puis les noms eux-mêmes. L'infobulle sur une barre donne toujours son nom en entier et sa lecture, et chaque partie revient dès que la cellule est assez large pour elle. | activé / désactivé | désactivé |
| Les empiler en une seule barre | Empile les catégories en une seule barre au lieu de les dresser côte à côte. Côte à côte répond à « combien chacune a fait »; empilées répond à « comment le tout se divise », qui est la question du graphique circulaire dessinée droit. | activé / désactivé | désactivé |
| Écrire chaque lecture sur sa barre | Écrit la valeur mise en forme sur chaque barre. Une cellule trop basse pour écrire les lectures au-dessus des barres dressées ou, quand les barres sont couchées, trop étroite pour les écrire à côté d'elles les laisse à l'infobulle. Une lecture qui serait écrite sur celle de sa voisine est aussi laissée à l'infobulle. | activé / désactivé | activé |
| Mini | Le bas auquel l'axe des valeurs est figé, dans l'unité des lectures. Vide laisse l'axe se réajuster à ce qui est lu, ce qui place la barre la plus haute en haut du sous-graphique quoi qu'elle ait mesuré. Une échelle figée est ce qui rend deux coups d'œil comparables. | nombre | vide (automatique) |
| Maxi | Le haut auquel l'axe des valeurs est figé. Les deux extrémités sont indépendantes : un plancher peut tenir pendant que le plafond suit les données. | nombre | vide (automatique) |
| Légende | Où la légende se pose. Offerte seulement tant que les barres sont empilées : dressées à part, les barres sont déjà nommées sur l'axe et une légende imprimerait la même liste deux fois; empilées en une seule colonne, la légende est la seule chose qui peut distinguer les segments. Une cellule trop étroite pour écrire tous les noms sur l'unique ligne de la légende énumère plutôt les segments, un par ligne : un nom plus long que sa ligne se termine par des points de suspension et l'infobulle de la ligne le donne en entier. La liste occupe au plus cinq lignes, et moins dans une cellule trop basse pour laisser en plus le tiers de sa hauteur au sous-graphique : avec plus de segments que de lignes, elle les affiche page par page, avec les flèches et le compteur de pages (par exemple 1/3) sur sa dernière ligne. La ligne revient dès que la cellule est assez large. | au-dessus du sous-graphique · en dessous du sous-graphique · aucune | au-dessus du sous-graphique |

Une cellule trop petite pour tout omet des parties avant que le sous-graphique devienne trop petit pour
être lu. Dans une cellule basse, les barres dressées côte à côte omettent d'abord les lectures
au-dessus d'elles, puis les noms en dessous, et les barres couchées, côte à côte ou empilées,
omettent les nombres de l'échelle en dessous. Dans une cellule étroite, les barres dressées, côte à
côte ou empilées, omettent les nombres de l'échelle à côté d'elles, et un nom sous une barre qui ne
tient plus se termine par des points de suspension. L'infobulle sur une barre donne toujours son
nom et sa lecture, et chaque partie revient dès que la cellule a la place pour elle.

## Les plages de l'échelle {#scale-bands}

La section **Échelle** déclare des tronçons de l'étendue des valeurs et ce que chacun veut dire, par le même éditeur de plages que chaque composant de visualisation partage. Sur un graphique en barres, les plages sont un nuancier : elles teintent les barres selon l'endroit où chaque lecture tombe, et rien de plus. Plusieurs lectures sont comparées à la fois, alors il n'y a pas un tronçon unique *dans* lequel le dessin se trouve : les plages ne portent ici aucun champ de libellé et aucun repère de référence n'est offert.

Chaque plage couvre tout jusqu'à sa borne, depuis là où la plage au-dessus d'elle dans la liste s'est arrêtée; une lecture au-delà de la dernière borne n'appartient à aucune plage et garde l'encre déclarée de la barre. La teinte nomme le sens (Neutre, Informatif, Succès, Prudence, Critique) et le thème en cours décide de la peinture.

## Boîte à outils {#toolbox}

La section **Boîte à outils** choisit les boutons dont l'opérateur dispose sur ce graphique. Une comparaison n'a aucun axe à parcourir, alors seuls les outils qu'elle peut honorer sont offerts; si aucun n'est coché, aucune barre d'outils n'est tracée.

| Outil | Ce qu'il fait | Dans le jeu par défaut |
|---|---|---|
| Enregistrer le PNG | Télécharge le dessin en PNG. | oui |
| Copier le PNG | Met le dessin dans le presse-papiers en PNG. | oui |
| Plein écran | Remplit la fenêtre avec ce graphique. | oui |