Class PieChartBuilder

PieChartBuilder

Un generatore di grafici a torta. Per maggiori dettagli, consulta la documentazione di Grafici Google.

Ecco un esempio che mostra come creare un grafico a torta. I dati sono importati da un foglio di lavoro Google. 

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

const chartBuilder = Charts.newPieChart()
                         .setTitle('World Population by Continent')
                         .setDimensions(600, 500)
                         .set3D()
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Metodi

MetodoTipo restituitoBreve descrizione
build()ChartCrea il grafico.
reverseCategories()PieChartBuilderInverte il disegno delle serie nell'asse del dominio.
set3D()PieChartBuilderImposta il grafico in tre dimensioni.
setBackgroundColor(cssValue)PieChartBuilderImposta il colore di sfondo del grafico.
setColors(cssValues)PieChartBuilderImposta i colori delle linee nel grafico.
setDataSourceUrl(url)PieChartBuilderImposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google.
setDataTable(tableBuilder)PieChartBuilderImposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder.
setDataTable(table)PieChartBuilderImposta la tabella dei dati contenente le linee del grafico, nonché le etichette dell'asse X.
setDataViewDefinition(dataViewDefinition)PieChartBuilderImposta la definizione della visualizzazione dei dati da utilizzare per il grafico.
setDimensions(width, height)PieChartBuilderImposta le dimensioni del grafico.
setLegendPosition(position)PieChartBuilderImposta la posizione della legenda rispetto al grafico.
setLegendTextStyle(textStyle)PieChartBuilderImposta lo stile del testo della legenda del grafico.
setOption(option, value)PieChartBuilderImposta le opzioni avanzate per questo grafico.
setTitle(chartTitle)PieChartBuilderImposta il titolo del grafico.
setTitleTextStyle(textStyle)PieChartBuilderImposta lo stile del testo del titolo del grafico.

Documentazione dettagliata

build()

Crea il grafico.

Indietro

Chart: un oggetto grafico, che può essere incorporato in documenti, elementi UI o utilizzato come immagine statica.

reverseCategories()

Inverte il disegno delle serie nell'asse del dominio. Per i grafici a intervallo verticale (come i grafici a linee, ad area o a colonne), l'asse orizzontale viene disegnato da destra a sinistra. Per i grafici a intervalli orizzontali (come i grafici a barre), ciò significa che l'asse verticale viene disegnato dall'alto verso il basso. Per i grafici a torta, significa che le sezioni vengono disegnate in senso antiorario. 

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

set3D()

Imposta il grafico in tre dimensioni.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setBackgroundColor(cssValue)

Imposta il colore di sfondo del grafico. 

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

Parametri

NomeTipoDescrizione
cssValueStringIl valore CSS per il colore (ad esempio "blue" o "#00f").

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setColors(cssValues)

Imposta i colori delle linee nel grafico. 

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

Parametri

NomeTipoDescrizione
cssValuesString[]Un array di valori CSS di colore, ad esempio ["red", "#acf"]. L'ennesimo elemento dell'array rappresenta il colore dell'ennesima linea del grafico.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setDataSourceUrl(url)

Imposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google. Se vengono forniti un URL dell'origine dati e una DataTable, l'URL dell'origine dati viene ignorato.

Per saperne di più sull'esecuzione di query sulle origini dati, consulta la documentazione di Grafici Google.

Parametri

NomeTipoDescrizione
urlStringL'URL dell'origine dati, inclusi eventuali parametri di query.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setDataTable(tableBuilder)

Imposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder. Si tratta di un metodo pratico per impostare la tabella dei dati senza dover chiamare build().

Parametri

NomeTipoDescrizione
tableBuilderDataTableBuilderUno strumento per la creazione di tabelle di dati. Una nuova tabella di dati viene creata immediatamente nell'ambito di questa chiamata, pertanto eventuali ulteriori aggiornamenti al generatore non verranno visualizzati nel grafico.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setDataTable(table)

Imposta la tabella dei dati contenente le linee del grafico, nonché le etichette dell'asse X. La prima colonna deve essere una stringa e contenere le etichette dell'asse orizzontale. Possono seguire un numero qualsiasi di colonne, tutte devono essere numeriche. Ogni colonna viene visualizzata come riga separata.

Parametri

NomeTipoDescrizione
tableDataTableSourceLa tabella di dati da utilizzare per il grafico.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setDataViewDefinition(dataViewDefinition)

Imposta la definizione della visualizzazione dei dati da utilizzare per il grafico.

Parametri

NomeTipoDescrizione
dataViewDefinitionDataViewDefinitionUn oggetto di definizione della visualizzazione dei dati che definisce la visualizzazione da derivare dall'origine dati specificata per il disegno del grafico.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setDimensions(width, height)

Imposta le dimensioni del grafico.

Parametri

NomeTipoDescrizione
widthIntegerLa larghezza del grafico, in pixel.
heightIntegerL'altezza del grafico, in pixel.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setLegendPosition(position)

Imposta la posizione della legenda rispetto al grafico. Per impostazione predefinita, non è presente alcuna legenda. 

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parametri

NomeTipoDescrizione
positionPositionLa posizione della legenda.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setLegendTextStyle(textStyle)

Imposta lo stile del testo della legenda del grafico. 

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parametri

NomeTipoDescrizione
textStyleTextStyleLo stile del testo da utilizzare per la legenda del grafico.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setOption(option, value)

Imposta le opzioni avanzate per questo grafico. Visualizza le opzioni disponibili per questo grafico. Questo metodo non ha effetto se l'opzione specificata non è valida. 

// Build a pie chart with a pretty legend.
const builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
const chart = builder.build();

Parametri

NomeTipoDescrizione
optionStringL'opzione da impostare.
valueObjectIl valore da impostare.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setTitle(chartTitle)

Imposta il titolo del grafico. Il titolo viene visualizzato centrato sopra il grafico. 

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

Parametri

NomeTipoDescrizione
chartTitleStringil titolo del grafico.

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.

setTitleTextStyle(textStyle)

Imposta lo stile del testo del titolo del grafico. 

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parametri

NomeTipoDescrizione
textStyleTextStyleLo stile del testo da utilizzare per il titolo del grafico. Puoi creare un oggetto TextStyleBuilder chiamando Charts.newTextStyle().

Indietro

PieChartBuilder: questo generatore è utile per il concatenamento.