Panoramica
Un grafico a candele interattivo.
Un grafico a candele viene utilizzato per mostrare un valore di apertura e chiusura sovrapposto a una varianza totale. I grafici a candele vengono spesso utilizzati per mostrare il comportamento del valore delle azioni. In questo grafico, gli elementi il cui valore di apertura è inferiore al valore di chiusura (un guadagno) vengono disegnati come caselle riempite e gli elementi il cui valore di apertura è superiore al valore di chiusura (una perdita) sono disegnati come caselle vuote.
Esempio
<html>
<head>
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script type="text/javascript">
google.charts.load('current', {'packages':['corechart']});
google.charts.setOnLoadCallback(drawChart);
function drawChart() {
var data = google.visualization.arrayToDataTable([
['Mon', 20, 28, 38, 45],
['Tue', 31, 38, 55, 66],
['Wed', 50, 55, 77, 80],
['Thu', 77, 77, 66, 50],
['Fri', 68, 66, 22, 15]
// Treat first row as data as well.
], true);
var options = {
legend:'none'
};
var chart = new google.visualization.CandlestickChart(document.getElementById('chart_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
Grafici a cascata
Con il giusto insieme di opzioni, puoi creare grafici a candele per assomigliare a semplici grafici a cascata.
Nel codice seguente, eliminiamo gli stoppini superiori inserendo gli stessi valori nella prima e nella seconda colonna e gli stoppini inferiori facendo corrispondere gli stessi valori nella terza e nella quarta colonna. Abbiamo impostato bar.groupWidth su '100%' per rimuovere lo spazio tra le barre.
<html>
<head>
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script type="text/javascript">
google.charts.load('current', {'packages':['corechart']});
google.charts.setOnLoadCallback(drawChart);
function drawChart() {
var data = google.visualization.arrayToDataTable([
['Mon', 28, 28, 38, 38],
['Tue', 38, 38, 55, 55],
['Wed', 55, 55, 77, 77],
['Thu', 77, 77, 66, 66],
['Fri', 66, 66, 22, 22]
// Treat the first row as data.
], true);
var options = {
legend: 'none',
bar: { groupWidth: '100%' }, // Remove space between bars.
candlestick: {
fallingColor: { strokeWidth: 0, fill: '#a52714' }, // red
risingColor: { strokeWidth: 0, fill: '#0f9d58' } // green
}
};
var chart = new google.visualization.CandlestickChart(document.getElementById('chart_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
Al momento non è possibile assegnare etichette alle barre in modo semplice. La soluzione migliore è utilizzare gli overlay.
Caricamento
Il nome del pacchetto google.charts.load è "corechart".
google.charts.load('current', {packages: ['corechart']});
Il nome della classe della visualizzazione è
google.visualization.CandlestickChart.
var visualization = new google.visualization.CandlestickChart(container);
Formato dei dati
Cinque o più colonne, in cui la prima colonna definisce valori dell'asse X o etichette di gruppo e ogni multiplo di quattro colonne di dati dopo definisce una serie diversa.
- Col 0: stringa (discreta) utilizzata come etichetta di gruppo sull'asse X, o numero, data, data/ora o ora del giorno (continua) utilizzata come valore sull'asse X.
- Col 1: numero che specifica il valore basso/minimo di questo indicatore. Questa è la base della linea centrale della candela. L'etichetta della colonna viene utilizzata come etichetta della serie nella legenda (mentre le etichette delle altre colonne vengono ignorate).
- Col 2: numero che specifica il valore di apertura/iniziale di questo indicatore. Questo è un bordo verticale della candela. Se inferiore al valore della colonna 3, la candela verrà riempita, altrimenti sarà vuota.
- Col 3: numero che specifica il valore di chiusura/finale dell'indicatore. Questo è il secondo bordo verticale della candela. Se inferiore al valore della colonna 2, la candela sarà vuota, altrimenti verrà riempita.
- Col 4: numero che specifica il valore massimo. È la parte superiore della linea centrale della candela.
- Col 5 [Facoltativo]: Una colonna descrizione comando o stile per la candela.
Opzioni di configurazione
| Nome | |
|---|---|
| AggregaTarget |
Come vengono raggruppate più selezioni di dati in descrizioni comando:
aggregationTarget verrà spesso utilizzato in coppia con selectionMode
e tooltip.trigger, ad esempio:
var options = {
// Allow multiple
// simultaneous selections.
selectionMode: 'multiple',
// Trigger tooltips
// on selections.
tooltip: {trigger: 'selection'},
// Group selections
// by x-value.
aggregationTarget: 'category',
};
Tipo: stringa
Predefinito: "auto"
|
| animazione.durata |
La durata dell'animazione espressa in millisecondi. Per maggiori dettagli, consulta la documentazione relativa all'animazione. Tipo: numero
Predefinito: 0
|
| animazione.Misure |
La funzione di adattamento applicata all'animazione. Sono disponibili le seguenti opzioni:
Tipo: stringa
Predefinito: "lineare"
|
| animazione.avvio |
Determina se il grafico verrà animato durante il disegno iniziale. Se Tipo: booleano
Predefinito falso
|
| posizione vari titoli |
Dove posizionare i titoli degli assi rispetto all'area del grafico. Valori supportati:
Tipo: stringa
Predefinito: "out"
|
| coloredisfondo |
Il colore dello sfondo dell'area principale del grafico. Può essere una semplice stringa di colore HTML, ad esempio Tipo: stringa o oggetto
Predefinito: "bianco"
|
| coloreColore sfondo |
Il colore del bordo del grafico, come stringa di colore HTML. Tipo: stringa
Predefinito: "#666"
|
| sfondoColore.LarghezzaLarghezza |
La larghezza del bordo, in pixel. Tipo: numero
Predefinito: 0
|
| sfondocolore.fill |
Il colore di riempimento del grafico, come stringa del colore HTML. Tipo: stringa
Predefinito: "bianco"
|
| Larghezza bar.group |
La larghezza di un gruppo di candele, specificata in uno dei seguenti formati:
Tipo: numero o stringa
Predefinito: il rapporto d'oro, circa "61,8%".
|
| candela.hollowIsRising |
Se vero, le candele crescenti appariranno vuote e quelle cadute appariranno fisse, altrimenti verrà mostrato il contrario. Tipo: booleano
Predefinito: false (in seguito verrà impostato su true)
|
| candeliere.autunnaleColore.fill |
Il colore di riempimento delle candele che cadono, come una stringa di colore HTML. Tipo: stringa
Predefinito: auto (dipende dal colore della serie e hollowIsRising)
|
| candeliere.autunnaleColoreColore |
Il colore del tratto delle candele che cadono, come una stringa di colore HTML. Tipo: stringa
Predefinito: auto (colore della serie)
|
| candeliere.autunnaleColoreColore |
Lo spessore delle candele che cadono, come una stringa di colore HTML. Tipo: 2
Predefinito: numero
|
| candeliere.risqueColore.fill |
Il colore di riempimento delle candele alzate, come stringa di colore HTML. Tipo: stringa
Predefinito: auto (bianco o colore della serie, a seconda del valore di hollowIsRising)
|
| candeliere.risqueColore.tratto |
Il colore del tratto delle candele alzate, come stringa di colore HTML. Tipo: stringa
Predefinito: auto (il colore della serie o bianco, a seconda del valore di hollowIsRising)
|
| candeliere.risqueColore.barrato |
La larghezza del tratto delle candele alzate, come stringa di colore HTML. Tipo: numero
Predefinito: 2
|
| area grafico |
Un oggetto con membri per configurare il posizionamento e le dimensioni dell'area del grafico (dove viene tracciato il grafico stesso, escludendo l'asse e le legende). Sono supportati due formati: un numero o un
seguito da %. Un numero semplice è un valore in pixel; un numero seguito da % è una
percentuale. Esempio: Tipo: oggetto
Predefinito: null
|
| graficoArea.Sfondo Colore |
Colore sfondo area grafico. Una stringa utilizzata può essere una stringa esadecimale (ad es. "#fdc") o un nome di colore inglese. Quando si utilizza un oggetto, è possibile fornire le seguenti proprietà:
Tipo: stringa o oggetto
Predefinito: "bianco"
|
| chartArea.left |
La distanza desiderata dal bordo sinistro. Tipo: numero o stringa
Predefinito: automatica
|
| chartArea.top |
La distanza da cui tracciare il grafico dal bordo superiore. Tipo: numero o stringa
Predefinito: automatica
|
| graficoarea.larghezza |
Larghezza area grafico. Tipo: numero o stringa
Predefinito: automatica
|
| graficoArea.altezza |
Altezza area grafico. Tipo: numero o stringa
Predefinito: automatica
|
| colori |
I colori da utilizzare per gli elementi del grafico. Un array di stringhe, dove ogni elemento è una stringa di colore HTML, ad esempio Tipo: matrice di stringhe
Predefinito: colori predefiniti
|
| EnableInteractivity |
Indica se il grafico genera eventi basati sugli utenti o reagisce alle interazioni degli utenti. Se il valore è false, il grafico non mostrerà "seleziona" o altri eventi basati sulle interazioni (ma verrà generato eventi di errore o pronti) e non mostrerà il testo al passaggio del mouse o non cambierà in base all'input dell'utente. Tipo: booleano
Predefinito: true
|
| focustarget |
Il tipo di entità che riceve lo stato attivo al passaggio del mouse. Influisce anche sull'entità selezionata dal clic del mouse e sull'elemento della tabella dati associato agli eventi. Può essere uno dei seguenti:
La descrizione comando in "TargetTarget "categoria" mostra tutti i valori delle categorie. Ciò può essere utile per confrontare i valori di serie diverse. Tipo: stringa
Predefinito: "datum"
|
| Dimensione carattere |
Le dimensioni predefinite dei caratteri, in pixel, di tutto il testo nel grafico. Puoi eseguire l'override utilizzando le proprietà per specifici elementi del grafico. Tipo: numero
Predefinito: automatica
|
| Nome carattere |
Il tipo di carattere predefinito per tutto il testo nel grafico. Puoi eseguire l'override utilizzando le proprietà per specifici elementi del grafico. Tipo: stringa
Predefinito: "iframe"
|
| forceIFrame |
Disegna il grafico all'interno di un frame in linea. Tieni presente che su IE8, questa opzione viene ignorata, mentre tutti i grafici IE8 vengono disegnati negli i-frame. Tipo: booleano
Predefinito: falso
|
| asse |
Un oggetto con membri in grado di configurare vari elementi dell'asse orizzontale. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale dell'oggetto, come mostrato di seguito:
{
title: 'Hello',
titleTextStyle: {
color: '#FF0000'
}
}
Tipo: oggetto
Predefinito: null
|
| valore di riferimento base hAxis |
La base di riferimento per l'asse orizzontale. Questa opzione è supportata solo per un asse Tipo: numero
Predefinito: automatica
|
| ColoreAsse.BaselineAxi |
Il colore della base di riferimento per l'asse orizzontale. Può essere qualsiasi stringa di colore HTML, ad esempio: Questa opzione è supportata solo per un asse Tipo: numero
Predefinito: "nero"
|
| hAxis.direction |
La direzione in cui crescono i valori lungo l'asse orizzontale. Specifica Tipo: 1 o -1
Predefinito: 1
|
| Formato hAxis.format |
Una stringa di formato per le etichette numeriche o per assi data.
Per le etichette dell'asse numerico, questo è un sottoinsieme della formattazione decimale
del set di pattern ICU
. Ad esempio,
Per le etichette dell'asse delle date, questo è un sottoinsieme della formattazione della data
Set di pattern ICU
. Ad esempio, La formattazione effettiva applicata all'etichetta deriva dalla lingua in cui è stata caricata l'API. Per maggiori dettagli, consulta la pagina relativa al caricamento di grafici con impostazioni internazionali specifiche .
Per il calcolo dei valori tick e delle linee della griglia, verranno prese in considerazione diverse combinazioni alternative di tutte le opzioni della griglia pertinenti e le alternative verranno rifiutate se le etichette dei segni di spunta formattate sono duplicate o sovrapposte.
Puoi quindi specificare
Questa opzione è supportata solo per un asse
Tipo: stringa
Predefinito: automatica
|
| Linee hAxis.grid |
Un oggetto con proprietà per configurare le linee della griglia sull'asse orizzontale. Tieni presente che le linee della griglia dell'asse orizzontale vengono tracciate verticalmente. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale dell'oggetto, come mostrato di seguito: {color: '#333', minSpacing: 20}
Questa opzione è supportata solo per un asse
Tipo: oggetto
Predefinito: null
|
| hAxis.gridlines.color |
Il colore delle linee della griglia orizzontale all'interno dell'area del grafico. Specifica una stringa di colore HTML valida. Tipo: stringa
Predefinito: "#CCC"
|
| hAxis.gridlines.count |
Il numero approssimativo di linee orizzontali della griglia all'interno dell'area del grafico.
Se specifichi un numero positivo per Tipo: numero
Predefinito: -1
|
| hAxis.gridlines.interval |
Un array di dimensioni (come valori dei dati, non pixel) tra le linee della griglia adiacenti. Al momento, questa opzione è destinata solo agli assi numerici,
ma è analoga alle opzioni
Tipo: numero compreso tra 1 e 10, escluso 10.
Predefinito: calcolato
|
| hAxis.gridlines.minSSpaziatura |
Lo spazio minimo dello schermo, in pixel, tra le linee della griglia principale di hAxis.
Il valore predefinito per le linee della griglia principale è Tipo: numero
Predefinito: calcolato
|
| hAxis.gridlines.multi |
Tutti i valori della griglia e della selezione devono essere un multiplo del valore di questa opzione. A differenza degli intervalli, le potenze 10 volte il multiplo non vengono prese in considerazione.
Puoi forzare l'inserimento dei tick in numeri interi specificando
Tipo: numero
Predefinito: 1
|
| hhAxis.gridlines.units |
Esegue l'override del formato predefinito per vari aspetti dei tipi di dati data/ora/ora del giorno quando utilizzato con le linee della griglia calcolate dal grafico. Consente la formattazione per anni, mesi, giorni, ore, minuti, secondi e millisecondi. Il formato generale è:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
Ulteriori informazioni sono disponibili in Date e ore. Tipo: oggetto
Predefinito: null
|
| Linee griglia hAxis.minor |
Un oggetto con membri per configurare le linee della griglia minori sull'asse orizzontale, in modo simile all'opzione hAxis.gridlines.
Questa opzione è supportata solo per un asse
Tipo: oggetto
Predefinito: null
|
| coloreAH.MinorGridlines.color |
Il colore delle linee della griglia secondaria orizzontale all'interno dell'area del grafico. Specifica una stringa di colore HTML valida. Tipo: stringa
Predefinito:una combinazione dei colori della linea di griglia e dello sfondo
|
| hAxis.minorGridlines.interval |
L'opzione minorGridlines.interval è come l'opzione dell'intervallo principale delle linee della griglia, ma l'intervallo scelto sarà sempre un divisore uniforme dell'intervallo della griglia principale.
L'intervallo predefinito per le scale lineari è
Tipo: numero
Predefinito: 1
|
| hAxis.minorGridlines.minSSpaziatura |
Lo spazio minimo richiesto, in pixel, tra le linee della griglia secondaria adiacenti e tra le linee della griglia secondaria e principale. Il valore predefinito è 1/2 del valore di minSSpaziatura delle linee della griglia principale per le scale lineari e 1/5 del valore di spaziatura minima per le scale di log. Tipo: numero
Predefinito:calcolato
|
| hAxis.minorGridlines.more |
Come nel caso del Tipo: numero
Predefinito: 1
|
| hhAxis.minorGridlines.count |
L'opzione Tipo: numero
Predefinito: 1
|
| hAxis.minorGridlines.units |
Sostituisce il formato predefinito per vari aspetti dei tipi di dati data/ora/ora del giorno quando viene utilizzato con linee griglia secondarie calcolate. Consente la formattazione per anni, mesi, giorni, ore, minuti, secondi e millisecondi. Il formato generale è:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
Ulteriori informazioni sono disponibili in Date e ore. Tipo: oggetto
Predefinito: null
|
| Scala hAxis.log |
Proprietà Questa opzione è supportata solo per un asse Tipo: booleano
Predefinito: falso
|
| TipoAHAxis.scale |
Proprietà
Questa opzione è supportata solo per un asse Tipo: stringa
Valore predefinito: null
|
| hAxis.textPosition |
Posizione del testo dell'asse orizzontale rispetto all'area del grafico. Valori supportati: "out", "in", "nessuno". Tipo: stringa
Predefinito: "out"
|
| Stile testoAxis. |
Un oggetto che specifica lo stile di testo dell'asse orizzontale. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.ticks |
Sostituisce i segni di graduazione dell'asse X generati automaticamente con l'array specificato. Ogni elemento della matrice deve essere un valore di segno di spunta valido (ad esempio numero, data, data/ora o ora del giorno) o un oggetto. Se si tratta di un oggetto, deve avere una proprietà
La visualizzazione di finestra verrà espansa automaticamente in modo da includere i segni di graduazione minimo e massimo a meno che non specifichi un valore Esempi:
Questa opzione è supportata solo per un asse
Tipo: array di elementi
Predefinito: automatica
|
| titolo.axis. |
Tipo: stringa
Predefinito: null
|
| StileAnonim.titoloTesto |
Un oggetto che specifica lo stile del testo del titolo dell'asse orizzontale. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.allowContainerBoundaryTextCutoff |
Se il valore è false, le etichette più esterne verranno nascoste invece di consentire che vengano ritagliate dal contenitore del grafico. Se true, consentirà il ritaglio delle etichette. Questa opzione è supportata solo per un asse Tipo: booleano
Predefinito: falso
|
| Testo hAxis.slanted |
Se true, traccia il testo dell'asse orizzontale su un'angolazione per facilitare l'adattamento di più testo lungo l'asse; se è false, disegna il testo sull'asse orizzontale in verticale. Per impostazione predefinita, il testo è inclinato se non può adattarsi a tutte le esigenze quando viene disegnato in verticale. Tieni presente che questa opzione è disponibile solo quando
Tipo: booleano
Predefinito: automatica
|
| Angolo testo hAxis.slanted |
L'angolo del testo dell'asse orizzontale, se è disegnato. Ignorato se
Tipo: numero, -90-90
Predefinito: 30
|
| Alternativa hAxis.max |
Numero massimo di livelli di testo dell'asse orizzontale. Se le etichette di testo dell'asse sono troppo affollate, il server potrebbe spostare le etichette vicine verso l'alto o verso il basso per far sì che le etichette siano più vicine tra loro. Questo valore specifica il numero massimo di livelli da utilizzare; il server può utilizzare meno livelli, se le etichette possono rientrare senza sovrapporsi. Per le date e gli orari, il valore predefinito è 1. Tipo: numero
Predefinito: 2
|
| Linee hAxis.maxTextLines |
Numero massimo di righe consentite per le etichette di testo. Le etichette possono estendersi su più righe se sono troppo lunghe e il numero di righe è, per impostazione predefinita, limitato dall'altezza dello spazio disponibile. Tipo: numero
Predefinito: automatica
|
| Spaziatura min.AxiS.min |
Spaziatura orizzontale minima, in pixel, consentita tra due etichette di testo adiacenti. Se le etichette sono distanziate troppo o sono troppo lunghe, la spaziatura può scendere al di sotto di questa soglia e in questo caso verrà applicata una delle misure di esclusione delle etichette, ad esempio troncandone o eliminandone alcune. Tipo: numero
Predefinito: il valore di
hAxis.textStyle.fontSize |
| hhAxis.showTextEvery |
Numero di etichette dell'asse orizzontale da mostrare, dove 1 indica tutte le etichette, 2 indica le altre etichette e così via. L'impostazione predefinita prevede di mostrare il maggior numero possibile di etichette senza sovrapporsi. Tipo: numero
Predefinito: automatica
|
| Valore max hAxis |
Consente di spostare il valore massimo dell'asse orizzontale al valore specificato; sarà a destra nella maggior parte dei grafici. Ignorato se è impostato su un valore inferiore al valore x massimo dei dati.
Questa opzione è supportata solo per un asse
Tipo: numero
Predefinito: automatica
|
| Valore minimo hAxis |
Sposta il valore minimo dell'asse orizzontale sul valore specificato, che sarà spostato verso sinistra nella maggior parte dei grafici. Ignorato se è impostato su un valore maggiore del valore x minimo dei dati.
Questa opzione è supportata solo per un asse
Tipo: numero
Predefinito: automatica
|
| hhAxis.viewWindowMode |
Specifica come scalare l'asse orizzontale per eseguire il rendering dei valori all'interno dell'area del grafico. Sono supportati i seguenti valori di stringa:
Questa opzione è supportata solo per un asse
Tipo: stringa
Predefinita:
equivalente a "pretty", ma
haxis.viewWindow.min e
haxis.viewWindow.max hanno la precedenza, se utilizzati.
|
| hhAxis.viewWindow |
Specifica l'intervallo di ritaglio dell'asse orizzontale. Tipo: oggetto
Predefinito: null
|
| hhAxis.viewWindow.max |
Ignorato quando Tipo: numero
Predefinito: automatica
|
| hhAxis.viewWindow.min |
Ignorato quando Tipo: numero
Predefinito: automatica
|
| height |
Altezza del grafico in pixel. Tipo: numero
Predefinito: altezza dell'elemento contenitore
|
| leggenda |
Un oggetto con membri per configurare i vari aspetti della legenda. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale dell'oggetto, come mostrato di seguito: {position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Tipo: oggetto
Predefinito: null
|
| legenda.allineamento |
Allineamento della legenda. Può corrispondere a uno dei seguenti:
L'inizio, la parte centrale e la fine sono relative allo stile (verticale o orizzontale) della legenda. Ad esempio, nella legenda "destra", "inizio" e "fine" si trovano rispettivamente all'inizio e alla fine; per una legenda "in alto", "inizio" e "fine" si trovano rispettivamente a sinistra e a destra dell'area. Il valore predefinito dipende dalla posizione della legenda. Per le legende "in basso", il valore predefinito è "center"; le altre legende sono "start". Tipo: stringa
Predefinito: automatica
|
| legenda.maxRighe |
Numero massimo di righe nella legenda. Impostalo su un numero maggiore di uno per aggiungere righe alla legenda. Nota: la logica esatta utilizzata per determinare il numero effettivo di righe visualizzate è ancora in evoluzione. Al momento questa opzione funziona solo quando legend.position è "top". Tipo: numero
Predefinito: 1
|
| legend.pageIndex |
Indice della pagina della legenda selezionato per la prima volta. Tipo: numero
Predefinito: 0
|
| posizione.legenda |
Posizione della legenda. Può corrispondere a uno dei seguenti:
Tipo: stringa
Predefinito: "destra"
|
| legend.textStyle |
Un oggetto che specifica lo stile del testo della legenda. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| orientamento |
L'orientamento del grafico. Se impostato su Tipo: stringa
Predefinito: "orizzontale"
|
| categorieinverse |
Se il criterio è impostato su true, disegna la serie da destra a sinistra. L'impostazione predefinita è il disegno da sinistra a destra.
Questa opzione è supportata solo per un asse
Tipo: booleano
Predefinito: falso
|
| selezionemodalità |
Quando Tipo: stringa
Predefinito: "singolo"
|
| series |
Un array di oggetti, ognuno che descrive il formato della serie corrispondente nel grafico. Per utilizzare i valori predefiniti per una serie, specifica un oggetto vuoto {}. Se non viene specificato un valore o una serie, verrà utilizzato il valore globale. Ogni oggetto supporta le seguenti proprietà:
Puoi specificare un array di oggetti, ognuno dei quali si applica alla serie nell'ordine specificato, oppure un oggetto in cui ogni elemento secondario ha una chiave numerica che indica a quale serie si applica. Ad esempio, le due dichiarazioni che seguono sono identiche e dichiarano la prima serie come nera e assente dalla legenda e la quarta come rossa e assente dalla legenda:
series: [
{color: 'black', visibleInLegend: false}, {}, {},
{color: 'red', visibleInLegend: false}
]
series: {
0:{color: 'black', visibleInLegend: false},
3:{color: 'red', visibleInLegend: false}
}
Tipo: array di oggetti o oggetti con oggetti nidificati
Predefinito: {}
|
| tema |
Un tema è un insieme di valori di opzione predefiniti che funzionano insieme per ottenere un comportamento visivo o un comportamento specifico del grafico. Attualmente è disponibile un solo tema:
Tipo: stringa
Predefinito: null
|
| title |
Testo da visualizzare sopra il grafico. Tipo: stringa
Predefinito: nessun titolo
|
| titoloPosizione |
Dove posizionare il titolo del grafico rispetto all'area del grafico. Valori supportati:
Tipo: stringa
Predefinito: "out"
|
| titoloTestoStile |
Un oggetto che specifica lo stile del testo del titolo. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| descrizione comando |
Un oggetto con membri che possono configurare vari elementi della descrizione comando. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale dell'oggetto, come mostrato di seguito: {textStyle: {color: '#FF0000'}, showColorCode: true}
Tipo: oggetto
Predefinito: null
|
| tooltip.ignoreBounds |
Se impostato su Nota: questo vale solo per le descrizioni comando HTML. Se questa funzionalità è abilitata con le descrizioni comando SVG, l'eventuale overflow oltre i limiti del grafico verrà ritagliato. Per ulteriori dettagli, consulta la sezione Personalizzare i contenuti della descrizione comando. Tipo: booleano
Predefinito: falso
|
| descrizione comando.isHTML |
Se è impostato su true, utilizza le descrizioni comando visualizzate in HTML (anziché il rendering SVG). Per ulteriori dettagli, consulta la sezione Personalizzare i contenuti della descrizione comando. Nota: la personalizzazione dei contenuti della descrizione comando HTML tramite il ruolo dati della colonna Descrizione comando non è supportata dalla visualizzazione Grafico a bolle. Tipo: booleano
Predefinito: falso
|
| descrizione comando.showColorCode |
Se true, mostra i riquadri colorati accanto alle informazioni sulla serie nella descrizione comando. Il valore predefinito è true quando Tipo: booleano
Predefinito: automatica
|
| tooltip.textStyle |
Un oggetto che specifica lo stile di testo della descrizione comando. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| descrizione comando.trigger |
L'interazione dell'utente che determina la visualizzazione della descrizione comando:
Tipo: stringa
Predefinito: "concentrazione"
|
| vAx |
Specifica le proprietà per i singoli assi verticali se il grafico ha più assi verticali.
Ogni oggetto secondario è un oggetto
Per specificare un grafico con più assi verticali, innanzitutto definisci un nuovo asse utilizzando
{
series: {
2: {
targetAxisIndex:1
}
},
vAxes: {
1: {
title:'Losses',
textStyle: {color: 'red'}
}
}
}
Questa proprietà può essere un oggetto o un array: l'oggetto è una raccolta di oggetti, ciascuno con un'etichetta numerica che specifica l'asse che definisce, questo è il formato mostrato sopra; la matrice è un array di oggetti, uno per asse. Ad esempio, la seguente notazione in stile array è identica all'oggetto
vAxes: [
{}, // Nothing specified for axis 0
{
title:'Losses',
textStyle: {color: 'red'} // Axis 1
}
]
Tipo: array di oggetti o oggetti con oggetti secondari.
Predefinito: null
|
| vAxi |
Un oggetto con membri in grado di configurare vari elementi dell'asse verticale. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale dell'oggetto, come mostrato di seguito: {title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Tipo: oggetto
Predefinito: null
|
| Basebase vAxis |
Tipo: numero
Predefinito: automatica
|
| Colorev.base.vAxis |
Specifica il colore della base di riferimento per l'asse verticale. Può essere qualsiasi stringa di colore HTML, ad esempio: Tipo: numero
Predefinito: "nero"
|
| vAxis.direction |
La direzione in cui crescono i valori lungo l'asse verticale. Per impostazione predefinita, i valori bassi si trovano in fondo al grafico. Specifica Tipo: 1 o -1
Predefinito: 1
|
| Formato vAxis.format |
Una stringa di formato per le etichette degli assi numerici. Questo è un sottoinsieme del
set di pattern ICU
.
Ad esempio,
La formattazione effettiva applicata all'etichetta deriva dalla lingua in cui è stata caricata l'API. Per maggiori dettagli, consulta la pagina relativa al caricamento di grafici con impostazioni internazionali specifiche .
Per il calcolo dei valori tick e delle linee della griglia, verranno prese in considerazione diverse combinazioni alternative di tutte le opzioni della griglia pertinenti e le alternative verranno rifiutate se le etichette dei segni di spunta formattate sono duplicate o sovrapposte.
Puoi quindi specificare Tipo: stringa
Predefinito: automatica
|
| Linee vAxis.grid |
Un oggetto con membri per configurare le linee della griglia sull'asse verticale. Tieni presente che le linee della griglia dell'asse verticale vengono tracciate orizzontalmente. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale dell'oggetto, come mostrato di seguito: {color: '#333', minSpacing: 20}
Tipo: oggetto
Predefinito: null
|
| vAxis.gridlines.color; |
Il colore delle linee della griglia verticale all'interno dell'area del grafico. Specifica una stringa di colore HTML valida. Tipo: stringa
Predefinito: "#CCC"
|
| vAxis.gridlines.count |
Il numero approssimativo di linee orizzontali della griglia all'interno dell'area del grafico.
Se specifichi un numero positivo per Tipo: numero
Predefinito: -1
|
| vAxis.gridlines.interval |
Un array di dimensioni (come valori dei dati, non pixel) tra le linee della griglia adiacenti. Al momento, questa opzione è destinata solo agli assi numerici,
ma è analoga alle opzioni
Tipo: numero compreso tra 1 e 10, escluso 10.
Predefinito: calcolato
|
| vAxis.gridlines.minSSpaziatura |
Lo spazio minimo dello schermo, in pixel, tra le linee della griglia principale di hAxis.
Il valore predefinito per le linee della griglia principale è Tipo: numero
Predefinito: calcolato
|
| vAxis.gridlines.multi |
Tutti i valori della griglia e della selezione devono essere un multiplo del valore di questa opzione. A differenza degli intervalli, le potenze 10 volte il multiplo non vengono prese in considerazione.
Puoi forzare l'inserimento dei tick in numeri interi specificando
Tipo: numero
Predefinito: 1
|
| vAxis.gridlines.units; |
Esegue l'override del formato predefinito per vari aspetti dei tipi di dati data/ora/ora del giorno quando utilizzato con le linee della griglia calcolate dal grafico. Consente la formattazione per anni, mesi, giorni, ore, minuti, secondi e millisecondi. Il formato generale è:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]},
hours: {format: [/*format strings here*/]},
minutes: {format: [/*format strings here*/]},
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]}
}
}
Ulteriori informazioni sono disponibili in Date e ore. Tipo: oggetto
Predefinito: null
|
| Linee griglia vAxis.minor |
Un oggetto con membri per configurare le linee della griglia secondaria sull'asse verticale, in modo simile all'opzione vAxis.gridlines. Tipo: oggetto
Predefinito: null
|
| Colorev.MinorGridlines.color |
Il colore delle linee della griglia secondaria verticale all'interno dell'area del grafico. Specifica una stringa di colore HTML valida. Tipo: stringa
Predefinito: una combinazione dei colori della linea di griglia e dello sfondo
|
| vAxis.minorGridlines.count |
L'opzione minorGridlines.count è deprecata, ad eccezione della disattivazione delle linee della griglia secondaria impostando il conteggio su 0. Il numero di linee della griglia minori dipende dall'intervallo tra le linee della griglia principali (vedi vAxis.gridlines.interval) e dallo spazio minimo richiesto (vedi vAxis.minorGridlines.minSpacing). Tipo: numero
Predefinito: 1
|
| vAxis.minorGridlines.interval |
L'opzione minorGridlines.interval è come l'opzione dell'intervallo principale delle linee della griglia, ma l'intervallo scelto sarà sempre un divisore uniforme dell'intervallo della griglia principale.
L'intervallo predefinito per le scale lineari è
Tipo: numero
Predefinito: 1
|
| vAxis.minorGridlines.minSSpaziatura |
Lo spazio minimo richiesto, in pixel, tra le linee della griglia secondaria adiacenti e tra le linee della griglia secondaria e principale. Il valore predefinito è 1/2 del valore di minSSpaziatura delle linee della griglia principale per le scale lineari e 1/5 del valore di spaziatura minima per le scale di log. Tipo: numero
Predefinito:calcolato
|
| vAxis.minorGridlines.more |
Come nel caso del Tipo: numero
Predefinito: 1
|
| vAxis.minorGridlines.units |
Sostituisce il formato predefinito per vari aspetti dei tipi di dati data/ora/ora del giorno quando viene utilizzato con linee griglia secondarie calcolate. Consente la formattazione per anni, mesi, giorni, ore, minuti, secondi e millisecondi. Il formato generale è:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
Ulteriori informazioni sono disponibili in Date e ore. Tipo: oggetto
Predefinito: null
|
| vAxis.logScale |
Se true, rende l'asse verticale una scala logaritmica. Nota: tutti i valori devono essere positivi. Tipo: booleano
Predefinito: falso
|
| vAxis.scaleType |
Proprietà
Questa opzione è supportata solo per un asse Tipo: stringa
Predefinito: null
|
| vAxis.textPosition |
Posizione del testo dell'asse verticale, rispetto all'area del grafico. Valori supportati: "out", "in", "nessuno". Tipo: stringa
Predefinito: "out"
|
| stileAV.testo |
Un oggetto che specifica lo stile di testo dell'asse verticale. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.ticks |
Sostituisce i segni di graduazione dell'asse Y generati automaticamente con la matrice specificata. Ogni elemento della matrice deve essere un valore di segno di spunta valido (ad esempio numero, data, data/ora o ora del giorno) o un oggetto. Se si tratta di un oggetto, deve avere una proprietà
La visualizzazione di finestra verrà espansa automaticamente in modo da includere i segni di graduazione minimo e massimo a meno che non specifichi un valore Esempi:
Tipo: array di elementi
Predefinito: automatica
|
| Titolo vAxis |
Tipo: stringa
Predefinito: nessun titolo
|
| vAxis.titleTextStyle |
Un oggetto che specifica lo stile del testo del titolo dell'asse verticale. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo: oggetto
Predefinito:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| Valore massimo vAxis |
Sposta il valore massimo dell'asse verticale al valore specificato; questo sarà verso l'alto nella maggior parte dei grafici. Ignorato se è impostato su un valore inferiore al valore y massimo dei dati.
Tipo: numero
Predefinito: automatica
|
| Valorev.min.min |
Sposta il valore minimo dell'asse verticale al valore specificato; questo sarà verso il basso nella maggior parte dei grafici. Ignorato se è impostato su un valore maggiore di quello y minimo dei dati.
Tipo: numero
Predefinito: null
|
| vAxis.viewWindowMode |
Specifica come scalare l'asse verticale per eseguire il rendering dei valori all'interno dell'area del grafico. Sono supportati i seguenti valori di stringa:
Tipo: stringa
Predefinita:
equivalente a "pretty", ma
vaxis.viewWindow.min e
vaxis.viewWindow.max hanno la precedenza, se utilizzati.
|
| vAxis.viewWindow |
Specifica l'intervallo di ritaglio dell'asse verticale. Tipo: oggetto
Predefinito: null
|
| vAxis.viewWindow.max |
Il valore massimo dei dati verticali da visualizzare. Ignorato quando Tipo: numero
Predefinito: automatica
|
| vAxis.viewWindow.min |
Il valore minimo dei dati verticali da visualizzare. Ignorato quando Tipo: numero
Predefinito: automatica
|
| width |
La larghezza del grafico in pixel. Tipo: numero
Predefinito: larghezza dell'elemento che la contiene
|
Metodi
| Metodo | |
|---|---|
draw(data, options) |
Disegna il grafico. Il grafico accetta ulteriori chiamate ai metodi solo dopo l'attivazione dell'evento Tipo di reso: nessuno
|
getAction(actionID) |
Restituisce l'oggetto azione della descrizione comando con il Tipo di reso: oggetto
|
getBoundingBox(id) |
Restituisce un oggetto contenente i valori sinistro, superiore, larghezza e altezza dell'elemento del grafico
I valori sono relativi al contenitore del grafico. Chiamalo dopo il disegno del grafico. Tipo di reso: oggetto
|
getChartAreaBoundingBox() |
Restituisce un oggetto contenente il lato sinistro, superiore, la larghezza e l'altezza dei contenuti del grafico (escluse le etichette e la legenda):
I valori sono relativi al contenitore del grafico. Chiamalo dopo il disegno del grafico. Tipo di reso: oggetto
|
getChartLayoutInterface() |
Restituisce un oggetto contenente informazioni sul posizionamento sullo schermo del grafico e sui suoi elementi. Nell'oggetto restituito possono essere richiamati i metodi seguenti:
Chiamalo dopo il disegno del grafico. Tipo di reso: oggetto
|
getHAxisValue(xPosition, optional_axis_index) |
Restituisce il valore dei dati orizzontali a Esempio: Chiamalo dopo il disegno del grafico. Tipo di reso: numero
|
getImageURI() |
Restituisce il grafico serializzato come URI immagine. Chiamalo dopo il disegno del grafico. Consulta la sezione Stampa di grafici PNG. Tipo di reso: stringa
|
getSelection() |
Restituisce una matrice delle entità del grafico selezionate.
Le entità selezionabili sono le candele, le voci delle legende e le categorie.
Per questo grafico è possibile selezionare una sola entità alla volta.
Tipo di reso: array di elementi di selezione
|
getVAxisValue(yPosition, optional_axis_index) |
Restituisce il valore dei dati verticali in Esempio: Chiamalo dopo il disegno del grafico. Tipo di reso: numero
|
getXLocation(dataValue, optional_axis_index) |
Restituisce la coordinata x di pixel di Esempio: Chiamalo dopo il disegno del grafico. Tipo di reso: numero
|
getYLocation(dataValue, optional_axis_index) |
Restituisce la coordinata y di pixel Esempio: Chiamalo dopo il disegno del grafico. Tipo di reso: numero
|
removeAction(actionID) |
Rimuove dal grafico l'azione della descrizione comando con il Tipo di reso:
none |
setAction(action) |
Imposta un'azione della descrizione comando da eseguire quando l'utente fa clic sul testo dell'azione.
Il metodo
Tutte le azioni relative alla descrizione comando devono essere impostate prima di chiamare il metodo Tipo di reso:
none |
setSelection() |
Seleziona le entità del grafico specificate. Annulla qualsiasi selezione precedente.
Le entità selezionabili sono le candele, le voci delle legende e le categorie.
Per questo grafico è possibile selezionare una sola entità alla volta.
Tipo di reso: nessuno
|
clearChart() |
Cancella il grafico e rilascia tutte le risorse allocate. Tipo di reso: nessuno
|
Eventi
Per saperne di più su come utilizzare questi eventi, consulta Interattività di base, Gestione degli eventi ed Eventi di attivazione.
| Nome | |
|---|---|
animationfinish |
Attivato quando l'animazione di transizione è completa. Proprietà: nessuna
|
click |
Attivato quando l'utente fa clic all'interno del grafico. Può essere utilizzato per identificare quando gli utenti fanno clic su titolo, elementi dati, voci di legenda, assi, linee di griglia o etichette. Proprietà: targetID
|
error |
Attivato quando si verifica un errore durante il tentativo di rendering del grafico. Proprietà: id, messaggio
|
legendpagination |
Attivato quando l'utente fa clic sulle frecce di impaginazione della legenda. Rimanda l'indice della pagina attuale con base zero e il numero totale di pagine. Proprietà: currentPageIndex, totalpages
|
onmouseover |
Attivato quando l'utente passa il mouse sopra un'entità visiva. Rimanda gli indici delle righe e delle colonne dell'elemento della tabella dati corrispondente. Una candela è correlata a una cella della tabella di dati, una voce di legenda a una colonna (l'indice della riga è null) e una categoria a una riga (l'indice della colonna è null). Proprietà: riga, colonna
|
onmouseout |
Attivato quando l'utente allontana il puntatore del mouse da un'entità visiva. Rimanda gli indici delle righe e delle colonne dell'elemento della tabella dati corrispondente. Una candela è correlata a una cella della tabella di dati, una voce di legenda a una colonna (l'indice della riga è null) e una categoria a una riga (l'indice della colonna è null). Proprietà: riga, colonna
|
ready |
Il grafico è pronto per le chiamate ai metodi esterni. Se vuoi interagire con il grafico e chiamare i metodi dopo averlo disegnato, devi configurare un listener per questo evento prima di chiamare il metodo Proprietà: nessuna
|
select |
Attivato quando l'utente fa clic su un'entità visiva. Per sapere cosa è stato selezionato, chiama il numero
Proprietà: nessuna
|
Norme sui dati
Tutto il codice e i dati vengono elaborati e visualizzati nel browser. Nessun dato viene inviato ad alcun server.