Class TableChartBuilder

TableChartBuilder

Un generatore per i grafici a tabella. Per maggiori dettagli, consulta la documentazione di Grafici Google.

Ecco un esempio che mostra come creare un grafico a tabella. 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%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Metodi

MetodoTipo restituitoBreve descrizione
build()ChartCrea il grafico.
enablePaging(enablePaging)TableChartBuilderConsente di stabilire se attivare la paginazione dei dati.
enablePaging(pageSize)TableChartBuilderAttiva la paginazione e imposta il numero di righe in ogni pagina.
enablePaging(pageSize, startPage)TableChartBuilderAttiva la paginazione, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono basati su zero).
enableRtlTable(rtlEnabled)TableChartBuilderAggiunge il supporto di base per le lingue da destra a sinistra (come arabo o ebraico) invertendo l'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima colonna sia la colonna più a sinistra.
enableSorting(enableSorting)TableChartBuilderImposta se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.
setDataSourceUrl(url)TableChartBuilderImposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google.
setDataTable(tableBuilder)TableChartBuilderImposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder.
setDataTable(table)TableChartBuilderImposta la tabella dei dati contenente le linee del grafico, nonché le etichette dell'asse X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderImposta la definizione della visualizzazione dei dati da utilizzare per il grafico.
setDimensions(width, height)TableChartBuilderImposta le dimensioni del grafico.
setFirstRowNumber(number)TableChartBuilderImposta il numero di riga per la prima riga nella tabella dei dati.
setInitialSortingAscending(column)TableChartBuilderImposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (in ordine crescente).
setInitialSortingDescending(column)TableChartBuilderImposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (in ordine decrescente).
setOption(option, value)TableChartBuilderImposta le opzioni avanzate per questo grafico.
showRowNumberColumn(showRowNumber)TableChartBuilderImposta se mostrare il numero di riga come prima colonna della tabella.
useAlternatingRowStyle(alternate)TableChartBuilderImposta se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico a tabella.

Documentazione dettagliata

build()

Crea il grafico.

Indietro

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


enablePaging(enablePaging)

Consente di stabilire se attivare la paginazione dei dati.

Il comportamento predefinito prevede la paginazione disattivata. Se la paginazione è abilitata, le dimensioni predefinite della pagina sono 10.

Parametri

NomeTipoDescrizione
enablePagingBooleantrue se la paginazione deve essere attivata, false in caso contrario.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


enablePaging(pageSize)

Attiva la paginazione e imposta il numero di righe in ogni pagina.

La dimensione predefinita della pagina è 10.

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Parametri

NomeTipoDescrizione
pageSizeIntegerIl numero di righe in ogni pagina della tabella.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


enablePaging(pageSize, startPage)

Attiva la paginazione, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono basati su zero).

La dimensione pagina predefinita è 10 e la pagina iniziale predefinita è 0.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parametri

NomeTipoDescrizione
pageSizeIntegerIl numero di righe in ogni pagina della tabella.
startPageIntegerLa prima pagina della tabella da visualizzare (i numeri di pagina sono basati su zero).

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


enableRtlTable(rtlEnabled)

Aggiunge il supporto di base per le lingue da destra a sinistra (come arabo o ebraico) invertendo l'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima colonna sia la colonna più a sinistra.

Ciò non influisce sull'indice delle colonne nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione completa delle lingue bidirezionali (BiDi) non è supportata dalla visualizzazione della tabella anche con questa opzione. Questa opzione viene ignorata se attivi la paginazione (utilizzando l'opzione Pagina) o se la tabella ha barre di scorrimento perché hai specificato opzioni di altezza e larghezza inferiori alle dimensioni della tabella richieste. Il comportamento predefinito prevede il supporto RTL disattivato.

Parametri

NomeTipoDescrizione
rtlEnabledBooleantrue se deve essere attivato il supporto da destra a sinistra, false altrimenti.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


enableSorting(enableSorting)

Imposta se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.

Se l'ordinamento è attivato, quando gli utenti fanno clic sull'intestazione della colonna, le righe vengono ordinate automaticamente. Il comportamento predefinito è l'ordinamento abilitato.

Parametri

NomeTipoDescrizione
enableSortingBooleantrue per attivare l'ordinamento facendo clic sulle intestazioni delle colonne, false altrimenti.

Indietro

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

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

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

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

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

TableChartBuilder: questo generatore è utile per il concatenamento.


setFirstRowNumber(number)

Imposta il numero di riga per la prima riga nella tabella dei dati.

Il numero di riga predefinito della prima riga è 1.

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parametri

NomeTipoDescrizione
numberIntegerIl numero di riga della prima riga nella tabella dei dati.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


setInitialSortingAscending(column)

Imposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (in ordine crescente).

La colonna è ordinata in ordine crescente ed è contrassegnata da una piccola freccia che lo indica.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parametri

NomeTipoDescrizione
columnIntegerIl numero della colonna in base alla quale la tabella deve essere inizialmente ordinata.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


setInitialSortingDescending(column)

Imposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (in ordine decrescente).

La colonna è ordinata in ordine decrescente ed è contrassegnata da una piccola freccia che lo indica.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parametri

NomeTipoDescrizione
columnIntegerIl numero della colonna in base alla quale la tabella deve essere inizialmente ordinata.

Indietro

TableChartBuilder: 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 table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

Parametri

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

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


showRowNumberColumn(showRowNumber)

Imposta se mostrare il numero di riga come prima colonna della tabella.

Il comportamento predefinito non mostra i numeri di riga.

Parametri

NomeTipoDescrizione
showRowNumberBooleantrue se la prima colonna della tabella deve mostrare il numero di riga, false altrimenti.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.


useAlternatingRowStyle(alternate)

Imposta se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico a tabella.

Il comportamento predefinito prevede che le righe abbiano uno stile di colore alternato.

Parametri

NomeTipoDescrizione
alternateBooleantrue se gli stili di colore devono essere alternati, false altrimenti.

Indietro

TableChartBuilder: questo generatore è utile per il concatenamento.