Style de courbe : épaisseur et tirets

A line chart draws every series one pixel wide and solid. chls sets the width of the line in pixels, and turns a solid line into a dashed one.

Ce que contrôle chls

chls takes one group of up to three numbers per series, in the order the series appear in chd, separated by |: chls=<thickness>,<dash_length>,<space_length>. Only the thickness is required.

  • thickness is the width of the line in pixels. A series with no group of its own is drawn one pixel wide.
  • dash_length is the length of each dash, in pixels. Leave it out, or set it to 0, and the line stays solid.
  • space_length is the gap between two dashes, in pixels. Leave it out and the gap matches the dash length, so chls=2,8 draws eight pixel dashes separated by eight pixel gaps.

La syntaxe est celle qu'utilisait Google Image Charts, si bien qu'une valeur chls copiée depuis une ancienne URL chart.googleapis.com produit ici la même courbe.

Épaisseur de courbe

Un seul nombre par série définit l'épaisseur et laisse la courbe pleine. Ci-dessous, chls=1|4|8 dessine les trois séries à un, quatre et huit pixels.

https://image-charts.com/chart?cht=lc&chd=a:10,14,12,18,22,20%7C30,34,32,38,42,40%7C50,54,52,58,62,60&chco=1F3B99,00A550,E8622A&chls=1%7C4%7C8&chs=700x280&chxt=x,y&chdl=chls%3D1%7Cchls%3D4%7Cchls%3D8&chdlp=b&chtt=Line+thickness

Graphique en courbes à trois séries tracées à une épaisseur de un, quatre et huit pixels
La légende sous le graphique indique la valeur chls utilisée pour chaque série.

Courbes en tirets

Le deuxième nombre transforme la courbe en courbe en tirets, et le troisième définit l'espace. chls=2,6,3 est une courbe de deux pixels tracée en tirets de six pixels séparés par des espaces de trois pixels.

https://image-charts.com/chart?cht=lc&chd=a:10,14,12,18,22,20%7C30,34,32,38,42,40%7C50,54,52,58,62,60&chco=1F3B99,00A550,E8622A&chls=2%7C2,6,3%7C2,14,6&chs=700x280&chxt=x,y&chdl=solid%7C6+and+3%7C14+and+6&chdlp=b&chtt=Dash+patterns

Graphique en courbes comparant une courbe pleine à deux motifs de tirets de longueurs différentes
Les trois séries font deux pixels d'épaisseur. Seules les longueurs de tirets et d'espaces diffèrent, c'est donc le motif qui les distingue plutôt que l'épaisseur.

Les tirets sont la façon habituelle de signaler une série que le lecteur doit lire différemment, une prévision ou un seuil plutôt qu'une mesure. Garder la série en tirets à la même épaisseur que la série pleine la maintient lisible sans la faire crier.

Quels types de graphiques lisent chls

Les trois types de graphiques en courbes acceptent tous chls, et ils diffèrent par ce qu'ils dessinent autour de la courbe.

Types de graphiques en courbes et leurs axes par défaut
valeur chtCe qu'il dessine
lcUn graphique en courbes dont les points sont espacés régulièrement le long de l'axe x. Les lignes d'axe sont tracées par défaut.
lsLe même graphique sans lignes d'axe, ce qui est exactement une sparkline. Utile quand le graphique s'insère dans un tableau ou un e-mail.
lxyUn graphique en courbes où vous donnez les deux coordonnées de chaque point au lieu des seules valeurs y, sous forme de séries x et y alternées.

Ajouter :nda à l'un d'eux, comme dans cht=lc:nda, masque les lignes d'axe même lorsque chxt les a demandées.

https://image-charts.com/chart?cht=lxy&chd=a:5,20,40,70,90%7C10,35,25,60,50&chls=3&chco=1F3B99&chs=700x260&chxt=x,y&chtt=cht%3Dlxy

Un graphique en courbes lxy avec les coordonnées x et y données point par point, tracé sur trois pixels d'épaisseur
Un graphique lxy lit ses coordonnées par paires de séries, d'abord x, puis y. chls s'y applique exactement comme à lc.

Couleur, marqueurs et courbure

chls couvre l'épaisseur et les tirets, rien d'autre. Les couleurs des courbes viennent de chco, et les formes tracées à chaque point de données viennent de chm.

La courbure n'est pas configurable. Image-Charts applique le même léger arrondi à chaque point de données sur tous les graphiques en courbes, et aucun paramètre de requête ne le modifie, si bien qu'une demande de segments parfaitement droits ou d'une spline fortement lissée ne peut pas s'exprimer dans l'URL. La documentation de référence liste tous les paramètres acceptés par l'API.

Styliser un graphique en courbes

Créer un graphique