Panoramica
Un grafico a torta che viene visualizzato all’interno del browser utilizzando SVG o VML. Visualizza i suggerimenti quando si passa sopra le sezioni.,
Esempio
Fare un Grafico a Torta 3D
Se si imposta il is3D
opzione true
, yourpie grafico viene disegnato anche se ha tre dimensioni:
is3D
è false
per impostazione predefinita, così qui abbiamo esplicitamente impostata su true
:
Fare una Ciambella Grafico
Una ciambella grafico è un grafico a torta con un foro al centro., È possibile creare grafici a ciambella con l’opzionepieHole
:
L’opzionepieHole
deve essere impostata su un numero compreso tra 0 e 1, corrispondente al rapporto di raggi tra il foro e il grafico. I numeri tra 0,4 e 0,6 avranno un aspetto migliore sulla maggior parte dei grafici.I valori uguali o maggiori di 1 verranno ignorati e un valore di 0 chiuderà completamente il piehole.
Non è possibile combinare le opzioni pieHole
e is3D
; in tal caso, pieHole
verranno ignorate.,
Si noti che Google Charts tenta di posizionare l’etichetta il più vicino possibile al centro della sezione. Se hai un grafico a ciambella con justone slice, il centro della fetta potrebbe cadere nel foro della ciambella. In questo caso, cambiare il colore dell’etichetta:
var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' };
Ruotando un grafico a torta
Per impostazione predefinita, i grafici a torta iniziano con il bordo sinistro del primo slicepointing verso l’alto. Puoi cambiarlo con l’opzionepieStartAngle
:
Qui, ruotiamo il grafico in senso orario di 100 gradi con un’opzione di pieStartAngle: 100
., (Così scelto perché quel particolarangolo accade per rendere l’etichetta” italiana ” adatta all’interno della fetta.)
Esplosione di una Fetta
È possibile separare le fette di torta da il resto del grafico con il offset
proprietà slices
opzioni:
Per separare una sezione, creare un slices
oggetto e assegnare il relativo numero di slice un offset
tra 0 e 1., Di seguito, si assegna progressivamente più grandi offset a fette 4 (Gujarati), 12 (Marathi), 14 (Indonesiana) e 15 (Punjabi):
la Rimozione Fette
Per omettere una fetta, modificare il colorea 'transparent'
:
Abbiamo anche usato il pieStartAngle
per ruotare il grafico 135degrees, pieSliceText
per rimuovere il testo theslices, e tooltip.trigger
per disattivare le descrizioni comandi:
Fetta di Visibilità Soglia
È possibile impostare un valore come soglia per una fetta di torta, per rendere singolarmente., Questo valore corrisponde a una frazione del grafico (con l’intero grafico di valore 1). Per impostare questa soglia come percentuale del tutto, dividere la percentuale desiderata per 100 (per una soglia del 20%, il valore sarebbe 0.2).
sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.
Qualsiasi sezione inferiore a questa soglia verrà combinata in una singola sezione “Altra” e avrà il valore combinato di tutte le sezioni al di sotto della soglia.
Caricamento
Ilgoogle.charts.load
nome del pacchetto è"corechart"
.,
google.charts.load("current", {packages: });
Il nome della classe della visualizzazione ègoogle.visualization.PieChart
.
var visualization = new google.visualization.PieChart(container);
Formato dati
Righe: ogni riga della tabella rappresenta una sezione.
Colonne:
Configurazione > Opzioni
Nome | |
---|---|
backgroundColor |
Il colore di sfondo per l’area principale del grafico. Può essere una semplice stringa di colore HTML, ad esempio: Tipo: string o object
Default: ‘white’
|
backgroundColor.traccia |
Il colore del bordo del grafico, come una stringa di colore HTML. Tipo: string
Default: ‘#666’
|
backgroundColor.strokeWidth |
La larghezza del bordo, in pixel. Tipo: numero
Default: 0
|
backgroundColor.riempi |
Il colore di riempimento del grafico, come una stringa di colori HTML., Type: string
Default: ‘white’
|
chartArea |
Un oggetto con membri per configurare il posizionamento e la dimensione 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; un numero seguito da % è una percentuale. Esempio: Tipo: object
Default: null
|
chartArea.backgroundColor |
Colore di sfondo dell’area del grafico., Quando viene utilizzata una stringa, può essere una stringa esadecimale (ad esempio,’ #fdc’) o un nome di colore inglese. Quando si utilizza un oggetto, è possibile fornire le seguenti proprietà:
Tipo: string o object
Default: ‘white’
|
chartArea.sinistra |
Quanto lontano disegnare il grafico dal bordo sinistro., Tipo: numero o stringa
Default: auto
|
chartArea.top |
Quanto lontano disegnare il grafico dal bordo superiore. Tipo: numero o stringa
Default: auto
|
chartArea.larghezza |
Larghezza area grafico. Tipo: numero o stringa
Default: auto
|
chartArea.altezza |
Altezza area grafico. Tipo: numero o stringa
Default: auto
|
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: Type: Array of strings
Default: colori predefiniti
|
enableInteractivity |
Se il grafico genera eventi basati sull’utente o reagisce all’interazione dell’utente. Se false, il grafico non genererà “select” o altri eventi basati sull’interazione (ma genererà eventi ready o error) e non mostrerà hovertext o altrimenti cambierà a seconda dell’input dell’utente., Type: boolean
Default: true
|
fontSize |
La dimensione predefinita del carattere, in pixel, di tutto il testo nel grafico. È possibile sovrascriverlo utilizzando le proprietà per elementi grafici specifici. Type: number
Default: automatic
|
fontName |
Il carattere predefinito per tutto il testo nel grafico. È possibile sovrascriverlo utilizzando le proprietà per elementi grafici specifici. Type: string
Default: ‘Arial’
|
forceIFrame |
Disegna il grafico all’interno di un frame in linea., (Si noti che su IE8, questa opzione viene ignorata; tutti i grafici IE8 sono disegnati in i-frame.) Tipo: booleano
Default: false
|
altezza |
Altezza del grafico, in pixel. Type: number
Default: altezza dell’elemento contenente
|
is3D |
Se true, visualizza un grafico tridimensionale. Type: boolean
Default: false
|
legenda |
Un oggetto con membri per configurare vari aspetti della legenda., Per specificare le proprietà di questo oggetto, è possibile utilizzare la notazione letterale dell’oggetto, come mostrato qui: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: object
Default: null
|
legenda.allineamento |
Allineamento della legenda. Può essere uno dei seguenti:
Inizio, centro e fine sono relativi allo stile-verticale o orizzontale-della legenda. Ad esempio, in una legenda “destra”, “inizio” e “fine” si trovano rispettivamente in alto e in basso; 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 ‘bottom’, l’impostazione predefinita è’ center’; altre legende predefinite per’start’. Tipo: string
Default: automatico
|
legenda.posizione |
Posizione della legenda., Può essere uno dei seguenti:
Tipo: string
Default: ‘right’
|
legenda.maxLines |
Numero massimo di righe nella legenda. Impostalo su un numero maggiore di uno per aggiungere linee alla legenda., Nota: la logica esatta utilizzata per determinare il numero effettivo di linee renderizzate è ancora in flusso. Questa opzione attualmente funziona solo quando legenda.la posizione è ‘top’. Tipo: numero
Default: 1
|
legenda.textStyle |
Un oggetto che specifica lo stile del testo legenda. L’oggetto ha questo formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Il Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieHole |
Se tra 0 e 1, visualizza un grafico a ciambella. Il foro con ha un raggio uguale a Type: number
Default: 0
|
pieSliceBorderColor |
Il colore dei bordi della slice. Applicabile solo quando il grafico è bidimensionale., Digitare: string
Default: ‘white’
|
pieSliceText |
Il contenuto del testo visualizzato sulla fetta. Può essere uno dei seguenti:
Type: string
Default: ‘percentage’
|
pieSliceTextStyle |
Un oggetto che specifica lo stile del testo slice., L’oggetto ha questo formato: {color: <string>, fontName: <string>, fontSize: <number>} Il Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieStartAngle |
L’angolo, in gradi, per ruotare il grafico. L’impostazione predefinita di Type: number
Default:
0 |
reverseCategories |
Se true, disegna le sezioni in senso antiorario. Il valore predefinito è disegnare in senso orario. Type: boolean
Default: false
|
pieResidueSliceColor |
Color for the combination slice that holds all slices below sliceVisibilityThreshold., Digitare: string
Default: ‘#ccc’
|
pieResidueSliceLabel |
Un’etichetta per la sezione combinata che contiene tutte le sezioni sotto sliceVisibilityThreshold. Type: string
Default: ‘Other’
|
slices |
Un array di oggetti, ognuno dei quali descrive il formato della fetta corrispondente nella torta. Per utilizzare i valori predefiniti per una sezione, specificare un oggetto vuoto (ad esempio,
È possibile specificare un array di oggetti, ognuno dei quali si applica alla slice nell’ordine specificato, oppure è possibile specificare un oggetto in cui ogni figlio ha una chiave numerica che indica a quale slice si applica. Per esempio, le seguenti due dichiarazioni sono identici, e dichiarare la prima fetta, come il nero e il quarto come il rosso: slices: slices: {0: {color: 'black'}, 3: {color: 'red'}} Tipo: Array di oggetti, o di un oggetto con oggetti nidificati
Default: {}
|
sliceVisibilityThreshold |
Il valore frazionario della torta, al di sotto del quale una fetta non verrà visualizzata singolarmente., Tutte le sezioni che non hanno superato questa soglia saranno combinate in una singola sezione” Altra”, la cui dimensione è la somma di tutte le loro dimensioni. L’impostazione predefinita non è mostrare individualmente alcuna fetta che è più piccola di mezzo grado. // Slices less than 25% of the pie will be// combined into an "Other" slice.sliceVisibilityThreshold: .25 Tipo: numero
Default: Mezzo grado (.5/360 o 1/720 o .0014)
|
titolo |
Testo da visualizzare sopra il grafico. Type: string
Default: nessun titolo
|
titleTextStyle |
Un oggetto che specifica lo stile del testo del titolo., The object has this format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } The Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
tooltip |
An object with members to configure various tooltip elements., Per specificare le proprietà di questo oggetto, è possibile utilizzare la notazione letterale dell’oggetto, come mostrato qui: {textStyle: {color: '#FF0000'}, showColorCode: true} Type: object
Default: null
|
tooltip.ignoreBounds |
Se impostato su Nota: questo vale solo per i suggerimenti HTML. Se questo è abilitato con i tooltip SVG, qualsiasi overflow al di fuori dei limiti del grafico verrà ritagliato. Vedere Personalizzazione del contenuto del Tooltip per maggiori dettagli., Tipo: booleano
Default: false
|
suggerimento.isHtml |
Se impostato su true, utilizzare i suggerimenti HTML-rendered (anziché SVG-rendered). Vedere Personalizzazione del contenuto del Tooltip per maggiori dettagli. Nota: la personalizzazione del contenuto del tooltip HTML tramite il ruolo dati colonna tooltip non è supportata dalla visualizzazione del grafico a bolle. Tipo: booleano
Default: false
|
suggerimento.showColorCode |
Se true, mostra i quadrati colorati accanto alle informazioni sulla sezione nel suggerimento., Tipo: booleano
Default: false
|
suggerimento.testo |
Quali informazioni visualizzare quando l’utente passa sopra una fetta di torta. Sono supportati i seguenti valori:
Tipo: string
Default: ‘both’
|
tooltip.,textStyle |
An object that specifies the tooltip text style. The object has this format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } The Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
tooltip.,trigger |
L’interazione dell’utente che causa la visualizzazione del suggerimento:
Tipo: string
Default: ‘focus’
|
larghezza |
Larghezza del grafico, in pixel., Tipo: numero
di Default: la larghezza dell’elemento contenitore
|
Metodi
Metodo | |
---|---|
draw(data, options) |
Disegna il grafico. Il grafico accetta ulteriori chiamate di metodo solo dopo che l’evento Return Type: none
|
getAction(actionID) |
Restituisce l’oggetto action tooltip con il Return Type: object
|
getBoundingBox(id) |
Restituisce un oggetto contenente la sinistra, la parte superiore, la larghezza e l’altezza dell’elemento grafico
I valori sono relativi al contenitore del grafico. Chiama questo dopo che il grafico è stato disegnato. Return Type: object
|
getChartAreaBoundingBox() |
Restituisce un oggetto contenente la sinistra, la parte superiore, la larghezza e l’altezza del contenuto del grafico (es., escludendo le etichette e leggenda):
I valori sono relativi al contenitore della carta. Chiama questo dopo che il grafico è stato disegnato. Return Type: object
|
getChartLayoutInterface() |
Restituisce un oggetto contenente informazioni sul posizionamento sullo schermo del grafico e dei suoi elementi., I seguenti metodi può essere chiamato l’oggetto restituito:
Chiamare questo dopo che il grafico viene disegnato. Return Type: object
|
getHAxisValue(position, optional_axis_index) |
Restituisce il valore orizzontale logico a Esempio: Chiama questo dopo che il grafico è stato disegnato. Return Type: number
|
getImageURI() |
Restituisce il grafico serializzato come URI di immagine. Chiama questo dopo che il grafico è stato disegnato. Vedere Stampa di grafici PNG. Tipo di ritorno: string
|
getSelection() |
Restituisce un array delle entità del grafico selezionate. Le entità selezionabili sono sezioni e voci di legenda. Per questo grafico, è possibile selezionare una sola entità in un dato momento., Return Type: Array of selection elements
|
getVAxisValue(position, optional_axis_index) |
Restituisce il valore verticale logico a Esempio: Chiama questo dopo che il grafico è stato disegnato. Return Type: number
|
getXLocation(position, optional_axis_index) |
Restituisce la coordinata x dello schermo di Esempio: Chiama questo dopo che il grafico è stato disegnato. Return Type: number
|
getYLocation(position, optional_axis_index) |
Restituisce la coordinata y dello schermo di Esempio: Chiama questo dopo che il grafico è stato disegnato. Return Type: number
|
removeAction(actionID) |
Rimuove l’azione tooltip con la richiesta Tipo di ritorno:
none |
setAction(action) |
Imposta un’azione tooltip da eseguire quando l’utente fa clic sul testo dell’azione. Il metodo Qualsiasi azione tooltip deve essere impostata prima di chiamare il metodo Tipo di ritorno:
none |
setSelection() |
Seleziona le entità del grafico specificate. Annulla qualsiasi selezione precedente. Le entità selezionabili sono sezioni e voci di legenda. Per questo grafico, è possibile selezionare una sola entità alla volta. Return Type: none
|
clearChart() |
Cancella il grafico e rilascia tutte le risorse allocate. Return Type: none
|
Events
Per ulteriori informazioni su come utilizzare questi eventi, vedere Interattività di base, Gestione degli eventi e Attivazione degli eventi.
Nome | |
---|---|
click |
Attivato quando l’utente fa clic all’interno del grafico., Può essere utilizzato per identificare quando si fa clic su titolo, elementi di dati, voci di legenda, assi, griglie o etichette. Proprietà: targetID
|
error |
Attivato quando si verifica un errore durante il tentativo di rendering del grafico. Proprietà: id, messaggio
|
onmouseover |
Attivato quando l’utente passa il mouse su un’entità visiva. Restituisce gli indici di riga e colonna dell’elemento della tabella dati corrispondente. Una voce slice o legenda è correlata a una riga nella tabella dati (l’indice delle colonne è nullo)., Proprietà: row, column
|
onmouseout |
Attivato quando l’utente si allontana da un’entità visiva. Restituisce gli indici di riga e colonna dell’elemento della tabella dati corrispondente. Una voce slice o legenda è correlata a una riga nella tabella dati (l’indice delle colonne è nullo). Properties: row, column
|
ready |
Il grafico è pronto per le chiamate di metodo esterne., Se si desidera interagire con il grafico e chiamare i metodi dopo averlo disegnato, è necessario 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 cosa è stato selezionato, chiama Proprietà: nessuno
|
Politica dei dati
Tutto il codice e i dati vengono elaborati e resi nel browser., Nessun dato viene inviato a nessun server.