Élément de graphique

PropriétéTypeRequisExemplePlage de valeursDescription
chartTypestringtrue--Le type de graphique à afficher. Types pris en charge : bar, line, area, scatter, pie, doughnut, radar.
chartWidthnumbertrue-200 - 800La largeur de la toile du graphique, en pixels.
chartHeightnumbertrue-150 - 600La hauteur de la toile du graphique, en pixels.
bgColorstringfalse--La couleur de fond du graphique, au format hexadécimal.
bgAlphanumberfalse-0 - 1Le niveau de transparence de l'arrière-plan du graphique. 1 représente une opacité totale, et 0 représente une transparence totale.
showAxisbooleanfalse--Si le graphique doit afficher les axes.
axisColorstringfalse--La couleur des axes du graphique, au format hexadécimal.
axisWidthnumberfalse-1 - 10La largeur des axes du graphique, en pixels.
showGridbooleanfalse--Si le graphique doit afficher la grille.
gridColorstringfalse--La couleur de la grille du graphique, au format hexadécimal.
gridAlphanumberfalse-0 - 1Le niveau de transparence de la grille du graphique. 1 représente une opacité totale, et 0 représente une transparence totale.
showLabelsbooleanfalse--Si le graphique doit afficher les étiquettes.
labelStyleobjectfalse--Configuration du style de texte pour les étiquettes du graphique.
labelStyle.fillstringfalse--La couleur de la police des étiquettes du graphique, au format hexadécimal.
labelStyle.fontSizenumberfalse-8 - 100La taille de la police des étiquettes du graphique, en pixels.
labelStyle.fontFamilystringfalse--La famille de la police des étiquettes du graphique.
labelStyle.fontWeightstringfalse--Le poids de la police des étiquettes du graphique (par exemple, normal, gras).
labelStyle.strokestringfalse--La couleur de contour des étiquettes du graphique, au format hexadécimal.
labelStyle.strokeThicknessnumberfalse-0 - 10La largeur du contour des étiquettes du graphique, en pixels.
labelStyle.dropShadowbooleanfalse--Si l'effet d'ombre doit être activé pour les étiquettes du graphique.
labelStyle.dropShadowColorstringfalse--La couleur de l'ombre des étiquettes du graphique, au format hexadécimal.
labelStyle.dropShadowBlurnumberfalse-0 - 20Le rayon de flou de l'ombre de l'étiquette.
labelStyle.dropShadowDistancenumberfalse-0 - 20La distance de l'ombre de l'étiquette par rapport au texte.
labelStyle.dropShadowAnglenumberfalse-0 - 6.28L'angle de l'ombre de l'étiquette, en radians.
labelStyle.dropShadowAlphanumberfalse-0 - 1L'opacité de l'ombre de l'étiquette.
linePointStylestringfalse--Le style des points de données dans les graphiques linéaires/de zone. Options : rempli, vide.
lineSmoothbooleanfalse--Si les lignes doivent être lissées dans les graphiques linéaires/de zone.
lineAreaAlphanumberfalse-0 - 1Le niveau de transparence de la zone remplie dans les graphiques de zone.
showLegendbooleanfalse--Si le graphique doit afficher la légende.
legendPositionstringfalse--La position de la légende. Actuellement prend en charge : bas.
legendItemSizenumberfalse-10 - 30La taille des éléments de légende, en pixels.
legendGapnumberfalse-4 - 20L'écart entre les éléments de légende, en pixels.
showBarBackgroundbooleanfalse--Si l'arrière-plan des graphiques à barres doit être affiché.
barBackgroundColorstringfalse--La couleur de fond des barres, au format hexadécimal.
barBackgroundAlphanumberfalse-0 - 1Le niveau de transparence de l'arrière-plan des barres.
barOrientationstringfalse--L'orientation des barres. Options : vertical, horizontal.
barCornerRadiusnumberfalse-0 - 20Le rayon des coins des barres, en pixels.
dataSetarrayfalse--Un tableau d'ensembles de données utilisés pour rendre le graphique. Chaque ensemble de données contient un point temporel (dataTime) et des points de données (dataPoints).

Types de graphiques

La propriété chartType détermine le style de visualisation :

  • bar : Graphique à barres verticales ou horizontales
  • line : Graphique linéaire avec lissage optionnel
  • area : Graphique de zone avec régions remplies
  • scatter : Nuage de points avec des points de données
  • pie : Graphique en secteurs montrant des proportions
  • doughnut : Graphique en anneau (graphique en secteurs avec un trou au centre)
  • radar : Graphique radar/araignée

Structure des données

Le dataSet est un tableau d'objets de données, où chaque objet contient :

  • dataTime : Le point temporel relatif au ChartNode (en secondes)
  • dataPoints : Un tableau de points de données à afficher à ce moment

Chaque point de données dans dataPoints contient :

  • id : Identifiant unique pour le point de données
  • label : L'étiquette/le nom du point de données
  • value : La valeur numérique
  • color (optionnel) : Couleur personnalisée pour ce point de données au format hexadécimal

Style des étiquettes

L'objet labelStyle contrôle l'apparence des étiquettes de graphique :

  • Propriétés de police : fill, fontSize, fontFamily, fontWeight
  • Propriétés de contour : stroke, strokeThickness
  • Propriétés d'ombre : dropShadow, dropShadowColor, dropShadowBlur, dropShadowDistance, dropShadowAngle, dropShadowAlpha

Caractéristiques des graphiques linéaires et de zone

Pour les graphiques linéaires et de zone, vous pouvez configurer :

  • linePointStyle : Afficher les points de données comme des cercles remplis ou des cercles vides
  • lineSmooth : Activer des courbes lisses au lieu de lignes droites
  • lineAreaAlpha : Contrôler l'opacité de la zone remplie (uniquement pour les graphiques de zone)

Caractéristiques des graphiques à barres

Pour les graphiques à barres, vous pouvez configurer :

  • barOrientation : Afficher les barres verticalement ou horizontalement
  • barCornerRadius : Arrondir les coins des barres
  • showBarBackground : Afficher un arrière-plan derrière les barres
  • barBackgroundColor/barBackgroundAlpha : Styliser l'arrière-plan des barres

Configuration de la légende

Activer et personnaliser la légende du graphique :

  • showLegend : Basculer la visibilité de la légende
  • legendPosition : Position de la légende (actuellement prend en charge "bottom")
  • legendItemSize : Taille des indicateurs de couleur de la légende
  • legendGap : Espacement entre les éléments de la légende
chartElement.json
{
"id": "chart-element-id",
"type": "Chart",
"start": 0,
"duration": 10,
"trackIndex": 0,
"x": 100,
"y": 100,
"chartType": "bar",
"chartWidth": 800,
"chartHeight": 600,
"bgColor": "#ffffff",
"bgAlpha": 1,
"showAxis": true,
"axisColor": "#000000",
"axisWidth": 2,
"showGrid": true,
"gridColor": "#cccccc",
"gridAlpha": 0.5,
"showLabels": true,
"labelStyle": {
  "fill": "#333333",
  "fontSize": 12,
  "fontFamily": "Arial",
  "fontWeight": "normal",
  "stroke": "#000000",
  "strokeThickness": 0,
  "dropShadow": false,
  "dropShadowColor": "#000000",
  "dropShadowBlur": 4,
  "dropShadowDistance": 3,
  "dropShadowAngle": 1.2,
  "dropShadowAlpha": 1
},
"showLegend": true,
"legendPosition": "bottom",
"legendItemSize": 14,
"legendGap": 8,
"barOrientation": "vertical",
"barCornerRadius": 4,
"showBarBackground": false,
"barBackgroundColor": "#eeeeee",
"barBackgroundAlpha": 0.4,
"dataSet": [
  {
    "dataTime": 0,
    "dataPoints": [
      { "id": "1", "label": "A", "value": 10, "color": "#ff6384" },
      { "id": "2", "label": "B", "value": 20, "color": "#36a2eb" },
      { "id": "3", "label": "C", "value": 15, "color": "#ffce56" }
    ]
  },
  {
    "dataTime": 5,
    "dataPoints": [
      { "id": "1", "label": "A", "value": 25, "color": "#ff6384" },
      { "id": "2", "label": "B", "value": 18, "color": "#36a2eb" },
      { "id": "3", "label": "C", "value": 22, "color": "#ffce56" }
    ]
  }
]
}