Welcome to Our Website

Visualizzazione: Grafico a torta

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:'red' o'#00cc00', o un oggetto con le seguenti proprietà.,

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: chartArea:{left:20,top:0,width:'50%',height:'75%'}

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à:
  • stroke: il colore, fornito come stringa esadecimale o nome del colore inglese.
  • strokeWidth: se fornito, disegna un bordo attorno all’area del grafico della larghezza data (e con il colore di stroke).
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: colors:.

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:

  • ‘start’ – Allineato all’inizio dell’area allocata per la legenda.
  • ‘center’ – Centrato nell’area assegnata per la legenda.
  • ‘fine’ – Allineato alla fine dell’area assegnata per la legenda.,

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:

  • ‘bottom’ – Visualizza la legenda sotto il grafico.
  • ‘etichettato’ – Disegna linee che collegano le sezioni ai loro valori di dati.
  • ‘left’ – Visualizza la legenda a sinistra del grafico.
  • ‘none’ – Non visualizza alcuna legenda.
  • ‘right’ – Visualizza la legenda a destra del grafico.
  • ‘top’ – Visualizza la legenda sopra il grafico.
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 colorpuò essere qualsiasi stringa di colore HTML, ad esempio: 'red'o '#00cc00'. Vedere anche fontNameefontSize.,

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 number volte il raggio del grafico.

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:

  • ‘percentuale’ – La percentuale della dimensione della fetta sul totale.
  • ‘valore’ – Il valore quantitativo della fetta.
  • ‘label’ – Il nome della sezione.
  • ‘none’ – Non viene visualizzato alcun testo.
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 colorpuò essere qualsiasi stringa di colore HTML, ad esempio: 'red'o '#00cc00'. Vedere anche fontNameefontSize.

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 0 orienterà il bordo più a sinistra della prima sezione direttamente verso l’alto.,

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,{}). Se non viene specificato un slice o un valore, verrà utilizzato il valore globale., Ogni oggetto supporta le seguenti proprietà:

  • color – Il colore da utilizzare per questa sezione. Specificare una stringa di colore HTML valida.
  • offset – Fino a che punto separare la fetta dal resto della torta, da 0.0 (per niente) a 1.0 (il raggio della torta).
  • textStyle – Sostituisce ilpieSliceTextStyle globale per questa sezione.,

È 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 color can be any HTML color string, for example: 'red' or '#00cc00'. Also see fontName and fontSize.

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 sutrue, consente al disegno di tooltip di scorrere al di fuori dei limiti del grafico su tutti i lati.

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:

  • ‘entrambi’ – Visualizza sia il valore assoluto della fetta che la percentuale dell’intero.
  • ‘valore’ – Visualizza solo il valore assoluto della fetta.
  • ‘percentuale’ – Visualizza solo la percentuale del tutto rappresentato dalla fetta.
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 color can be any HTML color string, for example: 'red' or '#00cc00'. Also see fontName and fontSize.

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:

  • ‘focus’ – Il suggerimento verrà visualizzato quando l’utente passa sopra l’elemento.
  • ‘none’ – Il suggerimento non verrà visualizzato.
  • ‘selezione’ – Il suggerimento verrà visualizzato quando l’utente seleziona l’elemento.
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 readyè stato attivato. Extended description.

Return Type: none
getAction(actionID)

Restituisce l’oggetto action tooltip con il actionID richiesto.,

Return Type: object
getBoundingBox(id)

Restituisce un oggetto contenente la sinistra, la parte superiore, la larghezza e l’altezza dell’elemento grafico id., Il formato id non è ancora stato documentato (sono i valori di ritorno di gestori di eventi), ma qui ci sono alcuni esempi:

var cli = chart.getChartLayoutInterface();
Altezza dell’area del grafico cli.getBoundingBox('chartarea').height Larghezza della terza battuta nella prima serie di un bar o di un grafico a colonne cli.getBoundingBox('bar#0#2').width riquadro di Delimitazione del quinto tassello di un grafico a torta cli.getBoundingBox('slice#4') Riquadro dei dati del grafico di una verticale (ad esempio, colonna) grafico: cli.getBoundingBox('vAxis#0#gridline') riquadro dei dati del grafico di una orizzontale (ad es.,, bar) grafico: cli.getBoundingBox('hAxis#0#gridline')

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):

var cli = chart.getChartLayoutInterface();
cli.getChartAreaBoundingBox().left cli.getChartAreaBoundingBox().top cli.getChartAreaBoundingBox().height cli.getChartAreaBoundingBox().width

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:

  • getBoundingBox
  • getChartAreaBoundingBox
  • getHAxisValue
  • getVAxisValue
  • getXLocation
  • getYLocation

Chiamare questo dopo che il grafico viene disegnato.

Return Type: object
getHAxisValue(position, optional_axis_index)

Restituisce il valore orizzontale logico a position, che è un offset dal bordo sinistro del contenitore grafico. Può essere negativo.,

Esempio:chart.getChartLayoutInterface().getHAxisValue(400).

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., Extended description.

Return Type: Array of selection elements
getVAxisValue(position, optional_axis_index)

Restituisce il valore verticale logico a position, che è un offset dal bordo superiore del contenitore grafico. Può essere negativo.

Esempio: chart.getChartLayoutInterface().getVAxisValue(300).

Chiama questo dopo che il grafico è stato disegnato.

Return Type: number
getXLocation(position, optional_axis_index)

Restituisce la coordinata x dello schermo di position relativa al contenitore del grafico.,

Esempio: chart.getChartLayoutInterface().getXLocation(400).

Chiama questo dopo che il grafico è stato disegnato.

Return Type: number
getYLocation(position, optional_axis_index)

Restituisce la coordinata y dello schermo di position relativa al contenitore del grafico.

Esempio: chart.getChartLayoutInterface().getYLocation(300).

Chiama questo dopo che il grafico è stato disegnato.

Return Type: number
removeAction(actionID)

Rimuove l’azione tooltip con la richiesta actionID dal grafico.,

Tipo di ritorno: none
setAction(action)

Imposta un’azione tooltip da eseguire quando l’utente fa clic sul testo dell’azione.

Il metodo setAction prende un oggetto come parametro di azione. Questo oggetto deve specificare 3 proprietà: id l’ID dell’azione che sta per essere impostato, text —il testo che deve essere visualizzato nella descrizione dell’azione e action la funzione che deve essere eseguito quando un utente fa clic sul testo dell’azione.,

Qualsiasi azione tooltip deve essere impostata prima di chiamare il metododraw() del grafico. Descrizione estesa.

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. Extended description.,

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 draw e chiamarli solo dopo che l’evento è stato attivato.

Proprietà: nessuna
select

Attivato quando l’utente fa clic su un’entità visiva. Per sapere cosa è stato selezionato, chiama getSelection().

Proprietà: nessuno

Politica dei dati

Tutto il codice e i dati vengono elaborati e resi nel browser., Nessun dato viene inviato a nessun server.

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *