Class TableChartBuilder

TableChartBuilder

Un generatore di grafici a tabella. Per ulteriori dettagli, consulta la documentazione di Google Charts.

Ecco un esempio che mostra come creare un grafico a tabella. I dati vengono 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 (ad esempio 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 di dati contenente le linee per il 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 della prima riga della tabella di dati.
setInitialSortingAscending(column)TableChartBuilderImposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (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.

Invio

Chart: un oggetto Chart che può essere incorporato in documenti, elementi dell'interfaccia utente o utilizzato come immagine statica.


enablePaging(enablePaging)

Consente di stabilire se attivare la paginazione dei dati.

Il comportamento predefinito è la disattivazione della paginazione. Se l'impaginazione è attivata, le dimensioni della pagina predefinite sono 10.

Parametri

NomeTipoDescrizione
enablePagingBooleantrue se la paginazione deve essere attivata, false altrimenti.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


enablePaging(pageSize)

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

Le dimensioni della pagina predefinite sono 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.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


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

Le dimensioni pagina predefinite sono 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 partono da zero).

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


enableRtlTable(rtlEnabled)

Aggiunge il supporto di base per le lingue da destra a sinistra (ad esempio 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 di colonna 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 richieste della tabella. Il comportamento predefinito è il supporto RTL disattivato.

Parametri

NomeTipoDescrizione
rtlEnabledBooleantrue se deve essere attivata la funzionalità di scrittura da destra a sinistra, false altrimenti.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


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 in caso contrario.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


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 di origine dati e una DataTable, l'URL dell'origine dati viene ignorato.

Per saperne di più sulle query delle origini dati, consulta la documentazione di Google Charts.

Parametri

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

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


setDataTable(tableBuilder)

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

Parametri

NomeTipoDescrizione
tableBuilderDataTableBuilderUn generatore di tabelle di dati. Nell'ambito di questa chiamata viene creata immediatamente una nuova tabella di dati, pertanto eventuali ulteriori aggiornamenti del generatore non verranno applicati al grafico.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


setDataTable(table)

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

Parametri

NomeTipoDescrizione
tableDataTableSourceLa tabella di dati da utilizzare per il grafico.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


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 ricavare dall'origine dati specificata per il disegno del grafico.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


setDimensions(width, height)

Imposta le dimensioni del grafico.

Parametri

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

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


setFirstRowNumber(number)

Imposta il numero della prima riga della tabella di 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 della prima riga nella tabella di dati.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


setInitialSortingAscending(column)

Imposta l'indice della colonna in base alla quale la tabella deve essere inizialmente ordinata (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.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


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.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


setOption(option, value)

Imposta le opzioni avanzate per questo grafico. Consulta 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.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


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.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.


useAlternatingRowStyle(alternate)

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

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

Parametri

NomeTipoDescrizione
alternateBooleantrue se gli stili di colore devono essere alternati, false in caso contrario.

Invio

TableChartBuilder: questo builder è utile per l'accodamento.