Panoramica
Un grafico ad area con gradini che viene visualizzato nel browser utilizzando SVG o VML. Visualizza i suggerimenti quando passi il mouse sopra i passaggi.
Esempio semplice
<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([ ['Director (Year)', 'Rotten Tomatoes', 'IMDB'], ['Alfred Hitchcock (1935)', 8.4, 7.9], ['Ralph Thomas (1959)', 6.9, 6.5], ['Don Sharp (1978)', 6.5, 6.4], ['James Hawes (2008)', 4.4, 6.2] ]); var options = { title: 'The decline of \'The 39 Steps\'', vAxis: {title: 'Accumulated Rating'}, isStacked: true }; var chart = new google.visualization.SteppedAreaChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Alcune opzioni comuni
Come tutti i grafici Google, i grafici ad area con passi hanno molte opzioni, che vengono mostrate qui. Ecco un esempio che mostra alcuni dei più comuni:
Nel grafico sopra, abbiamo modificato il colore di sfondo con il backgroundColor
, abbiamo spostato la legenda in basso con legend.position
, rimosso le linee verticali impostando connectSteps
su falso e personalizzato i colori. Ecco come si fa:
var options = { backgroundColor: '#ddd', legend: { position: 'bottom' }, connectSteps: false, colors: ['#4374E0', '#53A8FB', '#F1CA3A', '#E49307'], isStacked: true, };
Grafici ad area in pila con rientri
I grafici ad area con rientri supportano anche l'impilamento, incluso il 100% dell'impilamento. Un grafico ad area in pila è un grafico ad area in cui i valori correlati sono posizionati uno sopra l'altro. I valori negativi vengono posizionati in ordine inverso rispetto alla base di riferimento del grafico. Per lo stacking al 100%, gli stack di elementi in ciascun valore di dominio vengono ridimensionati in modo che vengano sommati fino al 100%. Le opzioni sono isStacked: 'percent'
, che formatta ogni valore come percentuale del 100% e isStacked: 'relative'
, che formatta ogni valore come frazione di 1. Esiste anche un'opzione isStacked: 'absolute'
, che è equivalente a isStacked: true
.
Nota nel grafico in pila 100% a destra, i valori di segno di spunta sono scritti in base alla scala 0-1 relativa come frazioni di 1.
var options_stacked = { isStacked: true, height: 300, legend: {position: 'top', maxLines: 3}, vAxis: {minValue: 0} };
var options_fullStacked = { isStacked: 'relative', height: 300, legend: {position: 'top', maxLines: 3}, vAxis: { minValue: 0, ticks: [0, .3, .6, .9, 1] } };
Caricamento
Il nome del pacchetto google.charts.load
è "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
Il nome della classe della visualizzazione è google.visualization.SteppedAreaChart
.
var visualization = new google.visualization.SteppedAreaChart(container);
Formato dei dati
Righe:ogni riga nella tabella rappresenta un gruppo di barre.
Colonne:
Colonna 0 | Colonna 1 | … | Colonna N | |
---|---|---|---|---|
Finalità: | Etichette del gruppo asse X | Valori della barra 1 in questo gruppo | … | Valori della barra N in questo gruppo |
Tipo di dati: | string | number | … | number |
Ruolo: | dominio | dati | … | dati |
Ruoli di colonna facoltativi: | … |
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
|
Opacità area |
L'opacità predefinita dell'area sotto il passaggio, dove 0,0 è completamente trasparente e 1,0 è completamente opaco. Non influisce sull'opacità della linea dei passaggi. Per ottenere un grafico a linee con incrementi, imposta questo valore su 0. Per specificare l'opacità per una singola serie, imposta il valore Tipo: numero, 0,0-1,0
Predefinito: 0,3
|
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"
|
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
|
connessione |
Se è impostato su true, i passaggi verranno uniti per formare una linea a passi. In caso contrario, viene visualizzata solo una riga in alto. L'impostazione predefinita prevede la connessione tra i passaggi. Tipo: booleano
Predefinito: true
|
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
|
hAxis.direction |
La direzione in cui crescono i valori lungo l'asse orizzontale. Specifica Tipo: 1 o -1
Predefinito: 1
|
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:
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. 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
|
hhAxis.viewWindow |
Specifica l'intervallo di ritaglio dell'asse orizzontale. Tipo: oggetto
Predefinito: null
|
hhAxis.viewWindow.max |
L'indice di riga basato su zero in cui termina la finestra di ritaglio. I punti dati a questo indice e a quelli superiori verranno ritagliati. In combinazione con Ignorato quando Tipo: numero
Predefinito: automatica
|
hhAxis.viewWindow.min |
L'indice della riga basato su zero da cui inizia la finestra di ritaglio. I punti dati negli indici inferiori a questo valore verranno ritagliati. In combinazione con Ignorato quando Tipo: numero
Predefinito: automatica
|
height |
Altezza del grafico in pixel. Tipo: numero
Predefinito: altezza dell'elemento contenitore
|
in pila |
Se è impostato su true, consente di impilare gli elementi per tutte le serie a ogni valore di dominio. Nota: nei grafici Colonna, Area e SteppedArea, Google Graph inverte l'ordine delle voci della legenda in modo che corrispondano meglio all'insieme degli elementi della serie (ad esempio, la serie 0 sarà l'elemento più in basso nella legenda). Questo non si applica ai grafici a barre.
L'opzione Le opzioni per
Per la struttura al 100%, il valore calcolato per ciascun elemento viene visualizzato nella descrizione comando dopo il valore effettivo.
Per impostazione predefinita, l'asse target selezionerà i valori in base alla scala 0-1 relativa come frazioni di 1 per
Lo stack al 100% supporta solo valori di dati di tipo Tipo: booleano/stringa
Predefinito: falso
|
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
|
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>}
|
LineDashStyle |
Pattern da attivare e disattivare per le linee tratteggiate. Ad esempio, Tipo: matrice di numeri
Predefinito: null
|
categorieinverse |
Se il criterio è impostato su true, disegna la serie da destra a sinistra. L'impostazione predefinita è il disegno da sinistra a destra. 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
|
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.logScale |
Se true, rende l'asse verticale una scala logaritmica. Nota: tutti i valori devono essere positivi. Tipo: booleano
Predefinito: falso
|
vAxis.scaleType |
Proprietà
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 passaggi, voci di legenda e categorie.
Un passaggio corrisponde 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).
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 passaggi, voci di legenda e categorie.
Un passaggio corrisponde 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).
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. 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. 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.