Panoramica
Un grafico ad area con rientri visualizzato all'interno del 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 rientri offrono numerose opzioni, mostrate qui. Ecco un esempio che illustra alcuni dei più comuni:
Nel grafico riportato sopra abbiamo modificato il colore di sfondo con backgroundColor, spostato la legenda in basso con legend.position, rimosso le linee verticali impostando connectSteps su false e personalizzato i colori. Ecco come fare:
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 la sovrapposizione, tra cui la sovrapposizione al 100%. Un grafico ad area in pila con rientri è un grafico ad area con rientri che posiziona i valori correlati uno sopra l'altro. Se sono presenti valori negativi, questi vengono impilati in ordine inverso sotto la base di riferimento del grafico. Per lo stack al 100%, gli stack degli elementi in corrispondenza di ciascun valore di dominio vengono ridimensionati in modo da generare una somma pari al 100%. Le opzioni per farlo sono isStacked: 'percent', che formatta
ciascun valore come percentuale del 100%, e isStacked: 'relative', che
formatta ciascun valore come frazione di 1. Esiste anche un'opzione isStacked: 'absolute', che è
funzionalmente equivalente a isStacked: true.
Nota: nel grafico in pila 100% a destra, i valori di graduazione sono scritti in base alla scala 0-1 relativa sotto forma di 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 in corso...
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 | |
|---|---|---|---|---|
| Scopo: | Etichette gruppo asse X | Valori barra 1 in questo gruppo | ... | Valori a barre N in questo gruppo |
| Tipo di dati: | stringa | numero | ... | numero |
| Ruolo: | dominio | dati | ... | dati |
| Ruoli colonna facoltativi: | ... |
Opzioni di configurazione
| Nome | |
|---|---|
| aggregationTarget |
Come vengono raggruppate più selezioni di dati in descrizioni comando:
aggregationTarget viene 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: "automatico"
|
| animation.duration |
La durata dell'animazione, in millisecondi. Per maggiori dettagli, consulta la documentazione sull'animazione. Tipo:numero
Predefinito:0
|
| animation.easing |
La funzione di easing applicata all'animazione. Sono disponibili le seguenti opzioni:
Tipo:stringa
Predefinito: "lineare"
|
| animation.startup |
Determina se il grafico si anima sul disegno iniziale. Se Tipo: booleano
Predefinito: false
|
| areaOpacity |
L'opacità predefinita dell'area sotto il passaggio, dove 0,0 è completamente trasparente e 1,0
è completamente opaco. Non influisce sull'opacità della linea con rientri. Per creare un grafico a linee con rientri, 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
|
| axisTitlesPosition |
Dove posizionare i titoli degli assi rispetto all'area del grafico. Valori supportati:
Tipo:stringa
Predefinito: 'out'
|
| backgroundColor |
Il colore di sfondo per l'area principale del grafico. Può essere una semplice stringa di colore HTML,
ad esempio Tipo: stringa o oggetto
Predefinito: "bianco"
|
| backgroundColor.stroke |
Il colore del bordo del grafico, come stringa di colore HTML. Tipo:stringa
Predefinito: "#666"
|
| backgroundColor.strokeWidth |
Lo spessore del bordo, in pixel. Tipo:numero
Predefinito:0
|
| backgroundColor.fill |
Il colore di riempimento del grafico, come stringa di colore HTML. Tipo:stringa
Predefinito: "bianco"
|
| chartArea |
Un oggetto con membri per configurare il posizionamento e le dimensioni dell'area del grafico (dove viene disegnato il grafico stesso, esclusi assi e legende). Sono supportati due formati: un numero o un numero seguito da %. Un numero semplice è un valore in pixel, mentre un numero seguito da % è una percentuale. Esempio: Tipo:oggetto
Predefinito:null
|
| chartArea.backgroundColor |
Colore di sfondo dell'area del grafico. Quando si utilizza una stringa, 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 |
Quanto è distante il grafico dal bordo sinistro. Tipo:numero o stringa.
Predefinita: automatica
|
| chartArea.top |
Quanto è distante il grafico dal bordo superiore. Tipo:numero o stringa.
Predefinita: automatica
|
| chartArea.width |
Larghezza dell'area del grafico. Tipo:numero o stringa.
Predefinita: automatica
|
| chartArea.height |
Altezza dell'area del grafico. Tipo:numero o stringa.
Predefinita: automatica
|
| colori |
I colori da utilizzare per gli elementi del grafico. Un array di stringhe, in cui ogni elemento è una stringa di colore HTML, ad esempio: Tipo: array di stringhe
Predefinito:colori predefiniti
|
| connectSteps |
Se impostato su true, i passaggi verranno collegati in modo da formare una linea con rientri. In caso contrario, viene visualizzata solo una riga superiore. L'impostazione predefinita è collegare i passaggi. Tipo: booleano
Predefinito:true
|
| enableInteractivity |
Indica se il grafico genera eventi basati sugli utenti o reagisce all'interazione dell'utente. Se il valore è false, il grafico non genera eventi di tipo "select" o altri eventi basati sull'interazione (ma genera eventi pronti o di errore) e non mostra il testo del passaggio del mouse o altri eventi basati sull'input dell'utente. Tipo: booleano
Predefinito:true
|
| focusTarget |
Il tipo di entità che viene attivata al passaggio del mouse. Influisce anche sull'entità selezionata tramite il clic del mouse e sull'elemento della tabella di dati associato agli eventi. Può essere uno dei seguenti:
In focusTarget "category" la descrizione comando visualizza tutti i valori della categoria. Questo può essere utile per confrontare i valori di serie diverse. Tipo:stringa
Predefinito: "datum"
|
| fontSize |
La dimensione predefinita dei caratteri, in pixel, di tutto il testo nel grafico. Puoi eseguire l'override di questa preferenza utilizzando le proprietà per elementi specifici del grafico. Tipo:numero
Predefinito:automatico
|
| fontName |
Il tipo di carattere predefinito per tutto il testo del grafico. Puoi eseguire l'override di questa preferenza utilizzando le proprietà per elementi specifici del grafico. Tipo:stringa
Predefinito: 'Arial'
|
| forceIFrame |
Disegna il grafico all'interno di un frame in linea. Tieni presente che in IE8 questa opzione viene ignorata; tutti i grafici di IE8 vengono tracciati in i-frame. Tipo: booleano
Predefinito:false
|
| hAxis |
Un oggetto con membri per configurare vari elementi dell'asse orizzontale. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale oggetto, come mostrato qui:
{
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", "none". Tipo:stringa
Predefinito: 'out'
|
| hAxis.textStyle |
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
Predefinita:
{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 dell'array deve essere un valore di selezione valido (ad esempio un numero, una data, una data/ora o un'ora del giorno) oppure un oggetto. Se si tratta di un oggetto, deve avere una proprietà
viewWindow verrà espanso automaticamente per includere i segni di graduazione minimo e massimo, a meno che non specifichi un valore Esempi:
Tipo: array di elementi
Predefinita: automatica
|
| hAxis.title |
Tipo:stringa
Predefinito:null
|
| hAxis.titleTextStyle |
Un oggetto che specifica lo stile di testo del titolo dell'asse orizzontale. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo:oggetto
Predefinita:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.allowContainerBoundaryTextCutoff |
Se il valore è false, vengono nascoste le etichette più esterne anziché consentire che vengano ritagliate dal contenitore del grafico. Se impostato su true, consente il ritaglio delle etichette. Tipo: booleano
Predefinito:false
|
| hAxis.slantedText |
Se il valore è vero, disegna il testo sull'asse orizzontale con un angolo per far sì che sia più testo lungo l'asse; se il testo è falso, disegna il testo sull'asse orizzontale in verticale. Il comportamento predefinito prevede l'inclinazione del testo se non viene completamente adattato quando il testo è disegnato in verticale. Tieni presente che questa opzione è disponibile solo quando
Tipo: booleano
Predefinito:automatico
|
| hAxis.slantedTextAngle |
L'angolo del testo dell'asse orizzontale, se è inclinato. Ignorato se Tipo: numero, -90—90
Predefinito:30
|
| hAxis.maxAlternation |
Numero massimo di livelli di testo dell'asse orizzontale. Se le etichette di testo degli assi diventano troppo affollate, il server potrebbe spostare le etichette vicine verso l'alto o verso il basso per avvicinare le etichette. Questo valore specifica il maggior numero di livelli da utilizzare. Il server può utilizzare meno livelli se le etichette possono adattarsi senza sovrapposizioni. Per le date e gli orari, il valore predefinito è 1. Tipo:numero
Predefinito:2
|
| hAxis.maxTextLines |
Numero massimo di righe consentito 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
Predefinita: automatica
|
| hAxis.minTextSpacing |
Spaziatura orizzontale minima, in pixel, consentita tra due etichette di testo adiacenti. Se le etichette sono distanziate troppo densamente o sono troppo lunghe, la spaziatura può scendere al di sotto di questa soglia e, in questo caso, verrà applicata una delle misure per evitare l'ingombro (ad es.troncare le etichette o eliminarne alcune). Tipo:numero
Predefinito: il valore di
hAxis.textStyle.fontSize |
| hAxis.showTextEvery |
Numero di etichette sull'asse orizzontale da visualizzare, dove 1 significa mostrare ogni etichetta, 2 significa mostrare ogni altra etichetta e così via. L'impostazione predefinita è provare a mostrare il maggior numero possibile di etichette senza sovrapposizioni. Tipo:numero
Predefinito:automatico
|
| hAxis.viewWindow |
Specifica l'intervallo di ritaglio dell'asse orizzontale. Tipo:oggetto
Predefinito:null
|
| hAxis.viewWindow.max |
L'indice di riga in base zero dove termina la finestra di ritaglio. I punti dati a questo indice e a quelli superiori verranno ritagliati. Insieme a Ignorato quando il valore di Tipo:numero
Predefinita: automatica
|
| hAxis.viewWindow.min |
L'indice di riga in base zero in cui inizia la finestra di ritaglio. I punti dati in corrispondenza di indici inferiori a questo valore verranno ritagliati. Insieme a Ignorato quando il valore di Tipo:numero
Predefinita: automatica
|
| altezza |
Altezza del grafico, in pixel. Tipo:numero
Predefinita: altezza dell'elemento contenitore
|
| isStacked |
Se impostato su true, impila gli elementi di tutte le serie in base al valore di ciascun dominio. Nota: nei grafici Column, Area e SteppedArea, Google Graph inverte l'ordine degli elementi della legenda per corrispondere meglio alla sovrapposizione degli elementi della serie (ad esempio, la serie 0 sarà l'elemento della legenda più in basso). Questo non si applica ai grafici a barre.
L'opzione Le opzioni per
Per la sovrapposizione al 100%, il valore calcolato per ogni elemento verrà visualizzato nella descrizione comando dopo il valore effettivo.
Per impostazione predefinita, l'asse target utilizza i valori di spunta basati sulla scala 0-1 relativa come frazioni
di 1 per
Lo stack al 100% supporta solo i valori dei dati di tipo Tipo:booleano/stringa
Predefinito:false
|
| leggenda |
Un oggetto con membri per configurare vari aspetti della legenda. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale oggetto, come mostrato qui: {position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Tipo:oggetto
Predefinito:null
|
| legend.alignment |
Allineamento della legenda. Può corrispondere a uno dei seguenti:
Inizio, centro e fine sono relativi allo stile (verticale o orizzontale) della legenda. Ad esempio, in una legenda "a destra", "start" ed "end" si trovano rispettivamente in alto e in basso; per una legenda "in alto", "start" ed "end" si trovano rispettivamente a sinistra e a destra dell'area. Il valore predefinito dipende dalla posizione della legenda. Per le legende "bottom", il valore predefinito è "center", mentre per le altre legende è "start". Tipo:stringa
Predefinito:automatico
|
| legend.maxLines |
Numero massimo di righe nella legenda. Imposta questo valore su un numero maggiore di uno per aggiungere righe alla legenda. Nota: la logica esatta utilizzata per determinare il numero effettivo di linee visualizzate è ancora in flusso. Al momento questa opzione funziona solo quando legend.position è "top". Tipo:numero
Predefinito:1
|
| legend.position |
Posizione della legenda. Può corrispondere a uno dei seguenti:
Tipo:stringa
Predefinito: "right"
|
| legend.textStyle |
Un oggetto che specifica lo stile di testo della legenda. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo:oggetto
Predefinita:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| lineDashStyle |
Il pattern on/off per le linee tratteggiate. Ad esempio, Tipo: array di numeri
Predefinito:null
|
| reverseCategories |
Se il valore è impostato su true, le serie verranno tracciate da destra a sinistra. L'impostazione predefinita è disegnare da sinistra a destra. Tipo: booleano
Predefinito:false
|
| selectionMode |
Se il valore di Tipo:stringa
Predefinito: "singolo"
|
| serie |
Un array di oggetti, ognuno dei quali 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 puoi specificare un oggetto in cui ogni elemento figlio ha una chiave numerica che indica a quale serie si applica. Ad esempio, le due dichiarazioni seguenti 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 oppure oggetto con oggetti nidificati
Predefinito: {}
|
| tema |
Un tema è un insieme di valori di opzioni predefiniti che funzionano insieme per ottenere un comportamento o un effetto visivo specifico del grafico. Al momento è disponibile un solo tema:
Tipo:stringa
Predefinito:null
|
| title |
Testo da visualizzare sopra il grafico. Tipo:stringa
Predefinito:nessun titolo
|
| titlePosition |
Dove posizionare il titolo del grafico rispetto all'area del grafico. Valori supportati:
Tipo:stringa
Predefinito: 'out'
|
| titleTextStyle |
Un oggetto che specifica lo stile di testo del titolo. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo:oggetto
Predefinita:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| Descrizione comando |
Un oggetto con membri per configurare vari elementi della descrizione comando. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale oggetto, come mostrato qui: {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, qualsiasi overflow al di fuori dei limiti del grafico verrà ritagliato. Per ulteriori dettagli, consulta Personalizzazione dei contenuti della descrizione comando. Tipo: booleano
Predefinito:false
|
| tooltip.isHtml |
Se il criterio viene impostato su true, utilizza le descrizioni comando per il rendering HTML (anziché SVG). Per ulteriori dettagli, consulta Personalizzazione dei contenuti della descrizione comando. Nota: la personalizzazione dei contenuti della descrizione comando HTML tramite il ruolo dei dati della colonna della descrizione comando non è supportata dalla visualizzazione Grafico a bolle. Tipo: booleano
Predefinito:false
|
| tooltip.showColorCode |
Se il valore è vero, mostra i quadrati colorati accanto alle informazioni sulla serie nella descrizione comando. Il valore predefinito è true quando Tipo: booleano
Predefinito:automatico
|
| 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
Predefinita:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| tooltip.trigger |
L'interazione dell'utente che determina la visualizzazione della descrizione comando:
Tipo:stringa
Predefinito: "focus"
|
| vAxes |
Specifica le proprietà dei singoli assi verticali, se il grafico ha più assi verticali.
Ogni oggetto secondario è un oggetto
Per specificare un grafico con più assi verticali, definisci prima 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, ognuno con un'etichetta numerica che specifica l'asse definito. Questo è il formato mostrato sopra; l'array è 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 oppure oggetti con oggetti secondari
Predefinito:null
|
| vAxis |
Un oggetto con membri per configurare vari elementi dell'asse verticale. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale oggetto, come mostrato qui: {title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Tipo:oggetto
Predefinito:null
|
| vAxis.baseline |
Tipo:numero
Predefinito:automatico
|
| vAxis.baselineColor |
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 nella parte inferiore del grafico. Specifica Tipo: 1 o -1
Predefinito:1
|
| vAxis.format |
Una stringa di formato per le etichette dell'asse numerico. Questo è un sottoinsieme del
set di pattern di ICU
.
Ad esempio,
La formattazione effettiva applicata all'etichetta deriva dalle impostazioni internazionali con cui è stata caricata l'API. Per maggiori dettagli, consulta la sezione sul caricamento dei grafici con impostazioni internazionali specifiche .
Per il calcolo dei valori di selezione e delle linee della griglia, verranno prese in considerazione diverse combinazioni alternative di tutte le opzioni pertinenti delle linee della griglia e verranno rifiutate le alternative se le etichette di selezione formattate venissero duplicate o si sovrappongano.
Pertanto, puoi specificare Tipo:stringa
Predefinita: automatica
|
| vAxis.gridlines |
Un oggetto con membri per configurare le linee della griglia sull'asse verticale. Tieni presente che le linee della griglia dell'asse verticale sono disegnate orizzontalmente. Per specificare le proprietà di questo oggetto, puoi utilizzare la notazione letterale oggetto, come mostrato qui: {color: '#333', minSpacing: 20}
Tipo:oggetto
Predefinito:null
|
| vAxis.gridlines.color |
Il colore delle linee della griglia verticali 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 della griglia orizzontali all'interno dell'area del grafico.
Se specifichi un numero positivo per Tipo:numero
Predefinito: -1
|
| vAxis.minorGridlines |
Un oggetto con membri per configurare le linee della griglia minori sull'asse verticale, in modo simile all'opzione vAxis.gridlines. Tipo:oggetto
Predefinito:null
|
| vAxis.minorGridlines.color |
Il colore delle linee della griglia minori verticali all'interno dell'area del grafico. Specifica una stringa di colore HTML valida. Tipo:stringa
Predefinito:una combinazione dei colori della linea della griglia e dello sfondo
|
| vAxis.minorGridlines.count |
L'opzione minorGridlines.count è in gran parte deprecata, ad eccezione della disattivazione delle linee della griglia minori 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 lo spazio minimo richiesto (vedi vAxis.minorGridlines.minSpacing). Tipo:numero
Predefinito:1
|
| vAxis.logScale |
Se il valore è true, l'asse verticale diventa una scala logaritmica. Nota: tutti i valori devono essere positivi. Tipo: booleano
Predefinito:false
|
| vAxis.scaleType |
Proprietà
Tipo:stringa
Predefinito:null
|
| vAxis.textPosition |
Posizione del testo dell'asse verticale rispetto all'area del grafico. Valori supportati: "out", "in", "none". Tipo:stringa
Predefinito: 'out'
|
| vAxis.textStyle |
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
Predefinita:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.ticks |
Sostituisce i segni di graduazione dell'asse Y generati automaticamente con l'array specificato. Ogni elemento dell'array deve essere un valore di selezione valido (ad esempio un numero, una data, una data/ora o un'ora del giorno) oppure un oggetto. Se si tratta di un oggetto, deve avere una proprietà
viewWindow verrà espanso automaticamente per includere i segni di graduazione minimo e massimo, a meno che non specifichi un valore Esempi:
Tipo: array di elementi
Predefinita: automatica
|
| vAxis.title |
Proprietà Tipo:stringa
Predefinito:nessun titolo
|
| vAxis.titleTextStyle |
Un oggetto che specifica lo stile di testo del titolo dell'asse verticale. L'oggetto ha questo formato:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Tipo:oggetto
Predefinita:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.maxValue |
Sposta il valore massimo dell'asse verticale sul valore specificato; 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:automatico
|
| vAxis.minValue |
Sposta il valore minimo dell'asse verticale sul valore specificato. Sarà verso il basso nella maggior parte dei grafici. Ignorato se impostato su un valore maggiore del valore y minimo dei dati.
Tipo:numero
Predefinito:null
|
| vAxis.viewWindowMode |
Consente di specificare come scalare l'asse verticale per visualizzare i valori all'interno dell'area del grafico. Sono supportati i seguenti valori di stringa:
Tipo:stringa
Predefinita:
equivale 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 verticale massimo dei dati da visualizzare. Ignorato quando il valore di Tipo:numero
Predefinita: automatica
|
| vAxis.viewWindow.min |
Il valore verticale minimo dei dati da visualizzare. Ignorato quando il valore di Tipo:numero
Predefinita: automatica
|
| larghezza |
Larghezza del grafico, in pixel. Tipo:numero
Predefinita: larghezza dell'elemento contenitore
|
Metodi
| Metodo | |
|---|---|
draw(data, options) |
Disegna il grafico. Il grafico accetta ulteriori chiamate di metodo solo dopo che è stato attivato
l'evento Tipo di reso: nessuno
|
getAction(actionID) |
Restituisce l'oggetto azione descrizione comando con l'oggetto Tipo restituito: oggetto
|
getBoundingBox(id) |
Restituisce un oggetto contenente i valori sinistra, superiore, larghezza e altezza dell'elemento del grafico
I valori sono relativi al contenitore del grafico. Viene chiamato dopo che il grafico è stato disegnato. Tipo restituito: oggetto
|
getChartAreaBoundingBox() |
Restituisce un oggetto contenente i valori sinistra, superiore, larghezza e altezza dei contenuti del grafico (ovvero, escludendo etichette e legenda):
I valori sono relativi al contenitore del grafico. Viene chiamato dopo che il grafico è stato disegnato. Tipo restituito: oggetto
|
getChartLayoutInterface() |
Restituisce un oggetto contenente informazioni sul posizionamento del grafico e dei suoi elementi sullo schermo. I seguenti metodi possono essere chiamati sull'oggetto restituito:
Viene chiamato dopo che il grafico è stato disegnato. Tipo restituito: oggetto
|
getHAxisValue(xPosition, optional_axis_index) |
Restituisce il valore orizzontale dei dati in Esempio: Viene chiamato dopo che il grafico è stato disegnato. Tipo di reso:number
|
getImageURI() |
Restituisce il grafico serializzato come URI immagine. Viene chiamato dopo che il grafico è stato disegnato. Consulta la sezione Stampa di grafici PNG. Tipo di ritorno:stringa
|
getSelection() |
Restituisce un array delle entità del grafico selezionate.
Le entità selezionabili sono passi, voci della legenda e categorie.
Un passaggio corrisponde a una cella nella tabella dati, una voce di legenda a una colonna (l'indice di riga è nullo) e una categoria a una riga (l'indice di colonna è nullo).
Per questo grafico, è possibile selezionare una sola entità alla volta.
Tipo restituito: array di elementi di selezione
|
getVAxisValue(yPosition, optional_axis_index) |
Restituisce il valore dei dati verticali in Esempio: Viene chiamato dopo che il grafico è stato disegnato. Tipo di reso:number
|
getXLocation(dataValue, optional_axis_index) |
Restituisce la coordinata x dei pixel di Esempio: Viene chiamato dopo che il grafico è stato disegnato. Tipo di reso:number
|
getYLocation(dataValue, optional_axis_index) |
Restituisce la coordinata y dei pixel di Esempio: Viene chiamato dopo che il grafico è stato disegnato. Tipo di reso:number
|
removeAction(actionID) |
Rimuove l'azione della descrizione comando con l'oggetto 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
Qualsiasi azione della descrizione comando deve essere impostata prima di chiamare il metodo Tipo di reso:
none |
setSelection() |
Seleziona le entità del grafico specificate. Annulla la selezione precedente.
Le entità selezionabili sono passi, voci della legenda e categorie.
Un passaggio corrisponde a una cella nella tabella dati, una voce di legenda a una colonna (l'indice di riga è nullo) e una categoria a una riga (l'indice di colonna è nullo).
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 maggiori informazioni su come utilizzare questi eventi, consulta Interattività di base, Gestione degli eventi e Attivazione degli eventi.
| Nome | |
|---|---|
animationfinish |
Attivato al termine dell'animazione della transizione. Proprietà:nessuna
|
click |
Attivato quando l'utente fa clic all'interno del grafico. Può essere utilizzato per identificare quando viene fatto clic su titolo, elementi di dati, voci della legenda, assi, linee della 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. Restituisce l'indice di pagina in base zero della legenda attuale e il numero totale di pagine. Proprietà: currentPageIndex, totalPages
|
onmouseover |
Attivato quando l'utente passa il mouse sopra un'entità visiva. Restituisce gli indici di righe e colonne dell'elemento della tabella di dati corrispondente. Proprietà:riga, colonna
|
onmouseout |
Attivato quando l'utente allontana il mouse dall'entità visiva. Restituisce gli indici di righe e colonne dell'elemento della tabella di dati corrispondente. Proprietà:riga, colonna
|
ready |
Il grafico è pronto per le chiamate di metodi esterne. Se vuoi interagire con il grafico e richiamare i metodi dopo averlo tracciato, devi impostare 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 quali elementi sono stati selezionati, chiama
Proprietà:nessuna
|
Norme sui dati
Tutto il codice e i dati vengono elaborati e visualizzati nel browser. Nessun dato viene inviato a nessun server.