Elemento del Grafico

ProprietàTipoRichiestoEsempioIntervallo di valoriDescrizione
chartTypestringtrue--Il tipo di grafico da visualizzare. Tipi supportati: bar, line, area, scatter, pie, doughnut, radar.
chartWidthnumbertrue-200 - 800La larghezza della tela del grafico, in pixel.
chartHeightnumbertrue-150 - 600L'altezza della tela del grafico, in pixel.
bgColorstringfalse--Il colore di sfondo del grafico, in formato esadecimale.
bgAlphanumberfalse-0 - 1Il livello di trasparenza dello sfondo del grafico. 1 rappresenta opacità totale e 0 rappresenta trasparenza totale.
showAxisbooleanfalse--Se visualizzare gli assi del grafico.
axisColorstringfalse--Il colore degli assi del grafico, in formato esadecimale.
axisWidthnumberfalse-1 - 10La larghezza degli assi del grafico, in pixel.
showGridbooleanfalse--Se visualizzare la griglia del grafico.
gridColorstringfalse--Il colore della griglia del grafico, in formato esadecimale.
gridAlphanumberfalse-0 - 1Il livello di trasparenza della griglia del grafico. 1 rappresenta opacità totale e 0 rappresenta trasparenza totale.
showLabelsbooleanfalse--Se visualizzare le etichette del grafico.
labelStyleobjectfalse--Configurazione dello stile del testo per le etichette del grafico.
labelStyle.fillstringfalse--Il colore del font delle etichette del grafico, in formato esadecimale.
labelStyle.fontSizenumberfalse-8 - 100La dimensione del font delle etichette del grafico, in pixel.
labelStyle.fontFamilystringfalse--La famiglia di font delle etichette del grafico.
labelStyle.fontWeightstringfalse--Il peso del font delle etichette del grafico (es. normale, grassetto).
labelStyle.strokestringfalse--Il colore del contorno delle etichette del grafico, in formato esadecimale.
labelStyle.strokeThicknessnumberfalse-0 - 10La larghezza del contorno delle etichette del grafico, in pixel.
labelStyle.dropShadowbooleanfalse--Se abilitare l'effetto ombra per le etichette del grafico.
labelStyle.dropShadowColorstringfalse--Il colore dell'ombra delle etichette del grafico, in formato esadecimale.
labelStyle.dropShadowBlurnumberfalse-0 - 20Il raggio di sfocatura dell'ombra dell'etichetta.
labelStyle.dropShadowDistancenumberfalse-0 - 20La distanza dell'ombra dell'etichetta dal testo.
labelStyle.dropShadowAnglenumberfalse-0 - 6.28L'angolo dell'ombra dell'etichetta, in radianti.
labelStyle.dropShadowAlphanumberfalse-0 - 1L'opacità dell'ombra dell'etichetta.
linePointStylestringfalse--Lo stile dei punti dati nei grafici a linea/ad area. Opzioni: riempito, vuoto.
lineSmoothbooleanfalse--Se levigare le linee nei grafici a linea/ad area.
lineAreaAlphanumberfalse-0 - 1Il livello di trasparenza dell'area riempita nei grafici ad area.
showLegendbooleanfalse--Se visualizzare la legenda del grafico.
legendPositionstringfalse--La posizione della legenda. Attualmente supporta: bottom.
legendItemSizenumberfalse-10 - 30La dimensione degli elementi della legenda, in pixel.
legendGapnumberfalse-4 - 20Il gap tra gli elementi della legenda, in pixel.
showBarBackgroundbooleanfalse--Se visualizzare lo sfondo dei grafici a barre.
barBackgroundColorstringfalse--Il colore di sfondo delle barre, in formato esadecimale.
barBackgroundAlphanumberfalse-0 - 1Il livello di trasparenza dello sfondo delle barre.
barOrientationstringfalse--L'orientamento delle barre. Opzioni: verticale, orizzontale.
barCornerRadiusnumberfalse-0 - 20Il raggio degli angoli delle barre, in pixel.
dataSetarrayfalse--Un array di set di dati utilizzati per rendere il grafico. Ogni set di dati contiene un punto temporale (dataTime) e punti dati (dataPoints).

Tipi di Grafico

La proprietà chartType determina lo stile di visualizzazione:

  • bar: Grafico a barre verticale o orizzontale
  • line: Grafico a linee con levigatura opzionale
  • area: Grafico ad area con regioni riempite
  • scatter: Grafico a dispersione con punti dati
  • pie: Grafico a torta che mostra proporzioni
  • doughnut: Grafico a ciambella (grafico a torta con foro centrale)
  • radar: Grafico radar/spider

Struttura dei Dati

Il dataSet è un array di oggetti dati, dove ogni oggetto contiene:

  • dataTime: Il punto temporale relativo al ChartNode (in secondi)
  • dataPoints: Un array di punti dati da visualizzare in questo momento

Ogni punto dati in dataPoints contiene:

  • id: Identificatore univoco per il punto dati
  • label: L'etichetta/nome del punto dati
  • value: Il valore numerico
  • color (opzionale): Colore personalizzato per questo punto dati in formato esadecimale

Stile delle Etichette

L'oggetto labelStyle controlla l'aspetto delle etichette del grafico:

  • Proprietà del Font: fill, fontSize, fontFamily, fontWeight
  • Proprietà del Contorno: stroke, strokeThickness
  • Proprietà dell'Ombra: dropShadow, dropShadowColor, dropShadowBlur, dropShadowDistance, dropShadowAngle, dropShadowAlpha

Caratteristiche dei Grafici a Linea e ad Area

Per i grafici a linea e ad area, puoi configurare:

  • linePointStyle: Visualizzare i punti dati come cerchi riempiti o cerchi vuoti
  • lineSmooth: Abilitare curve morbide invece di linee dritte
  • lineAreaAlpha: Controllare l'opacità dell'area riempita (solo grafici ad area)

Caratteristiche dei Grafici a Barre

Per i grafici a barre, puoi configurare:

  • barOrientation: Visualizzare le barre verticalmente o orizzontalmente
  • barCornerRadius: Arrotondare gli angoli delle barre
  • showBarBackground: Visualizzare uno sfondo dietro le barre
  • barBackgroundColor/barBackgroundAlpha: Stilizzare lo sfondo delle barre

Configurazione della Legenda

Abilita e personalizza la legenda del grafico:

  • showLegend: Attivare/disattivare la visibilità della legenda
  • legendPosition: Posizione della legenda (attualmente supporta "bottom")
  • legendItemSize: Dimensione degli indicatori di colore della legenda
  • legendGap: Spaziatura tra gli elementi della legenda
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" }
    ]
  }
]
}