Uno strumento per la creazione di grafici a tabella. Per ulteriori informazioni, consulta la documentazione di Google Chart.
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. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; var chartBuilder = Charts.newTableChart() .setDimensions(600, 500) .enablePaging(20) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
build() | Chart | Crea il grafico. |
enablePaging(enablePaging) | TableChartBuilder | Consente di impostare se attivare il paging tra i dati. |
enablePaging(pageSize) | TableChartBuilder | Abilita il paging e imposta il numero di righe in ogni pagina. |
enablePaging(pageSize, startPage) | TableChartBuilder | Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero). |
enableRtlTable(rtlEnabled) | TableChartBuilder | Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'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 quella più a sinistra. |
enableSorting(enableSorting) | TableChartBuilder | Consente di scegliere se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna. |
setDataSourceUrl(url) | TableChartBuilder | Imposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google. |
setDataTable(tableBuilder) | TableChartBuilder | Imposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder. |
setDataTable(table) | TableChartBuilder | Imposta la tabella di dati che contiene le linee per il grafico e le etichette dell'asse X. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | Imposta la definizione della vista dati da utilizzare per il grafico. |
setDimensions(width, height) | TableChartBuilder | Imposta le dimensioni del grafico. |
setFirstRowNumber(number) | TableChartBuilder | Imposta il numero di riga per la prima riga nella tabella di dati. |
setInitialSortingAscending(column) | TableChartBuilder | Imposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente). |
setInitialSortingDescending(column) | TableChartBuilder | Imposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente). |
setOption(option, value) | TableChartBuilder | Imposta le opzioni avanzate per questo grafico. |
showRowNumberColumn(showRowNumber) | TableChartBuilder | Consente di impostare se mostrare il numero di riga come prima colonna della tabella. |
useAlternatingRowStyle(alternate) | TableChartBuilder | Consente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella. |
Documentazione dettagliata
build()
Crea il grafico.
Ritorni
Chart
: oggetto Chart che può essere incorporato in documenti ed elementi dell'interfaccia utente o utilizzato come immagine statica.
enablePaging(enablePaging)
Consente di impostare se attivare il paging tra i dati.
Il comportamento predefinito è il paging disabilitato. Se il paging è attivato, la dimensione predefinita della pagina è 10.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enablePaging | Boolean | true se deve essere attivato il paging, false in caso contrario. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
enablePaging(pageSize)
Abilita il paging 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. var builder = Charts.newTableChart(); builder.enablePaging(5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pageSize | Integer | Il numero di righe in ogni pagina della tabella. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
enablePaging(pageSize, startPage)
Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).
La dimensione predefinita della pagina è 10, mentre la pagina iniziale è 0.
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pageSize | Integer | Il numero di righe in ogni pagina della tabella. |
startPage | Integer | La prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero). |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
enableRtlTable(rtlEnabled)
Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'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 quella più a sinistra.
Ciò non influisce sull'indice della colonna nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione della lingua Bidirezionale completa (BiDi) non è supportata dalla visualizzazione tabulare anche con questa opzione. Questa opzione viene ignorata se attivi il paging (utilizzando l'opzione Pagina) o se la tabella presenta barre di scorrimento perché hai specificato opzioni di altezza e larghezza inferiori alle dimensioni richieste per la tabella. Il comportamento predefinito è il supporto RTL disattivato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rtlEnabled | Boolean | true se è necessario attivare il supporto da destra a sinistra, false
in caso contrario. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
enableSorting(enableSorting)
Consente di scegliere 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 di colonna, le righe vengono ordinate automaticamente. Il comportamento predefinito è l'ordinamento abilitato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enableSorting | Boolean | true per attivare l'ordinamento facendo clic sulle intestazioni di colonna, altrimenti false . |
Ritorni
TableChartBuilder
: questo builder, 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 di origine dati e una DataTable, l'URL dell'origine dati viene ignorato.
Per ulteriori informazioni sull'esecuzione di query sulle origini dati, consulta la documentazione di Grafici Google.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | L'URL dell'origine dati, inclusi eventuali parametri di ricerca. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setDataTable(tableBuilder)
Imposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder. Questo è un metodo pratico per impostare la tabella di dati senza dover chiamare build()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
tableBuilder | DataTableBuilder | Un generatore di tabelle di dati. Nell'ambito di questa chiamata viene creata immediatamente una nuova tabella di dati, pertanto eventuali ulteriori aggiornamenti al builder non saranno visualizzati nel grafico. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setDataTable(table)
Imposta la tabella di dati che contiene le linee per il grafico e 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 devono essere numeriche. Ogni colonna viene visualizzata come una riga separata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
table | DataTableSource | La tabella di dati da utilizzare per il grafico. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setDataViewDefinition(dataViewDefinition)
Imposta la definizione della vista dati da utilizzare per il grafico.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
dataViewDefinition | DataViewDefinition | Un oggetto di definizione delle viste dati che definisce la vista da derivare dall'origine dati specificata per il disegno del grafico. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setDimensions(width, height)
Imposta le dimensioni del grafico.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | La larghezza del grafico in pixel. |
height | Integer | L'altezza del grafico in pixel. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setFirstRowNumber(number)
Imposta il numero di riga per la prima riga nella tabella di dati.
Il numero predefinito della prima riga è 1.
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Integer | Il numero di riga per la prima riga nella tabella di dati. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setInitialSortingAscending(column)
Imposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente).
Il sistema operativo della colonna è ordinato in ordine crescente ed è contrassegnato da una piccola freccia che lo indica.
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | Integer | Il numero della colonna in base alla quale deve essere ordinata inizialmente la tabella. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
setInitialSortingDescending(column)
Imposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente).
Il sistema operativo della colonna è ordinato in ordine decrescente ed è contrassegnato da una piccola freccia che lo indica.
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
column | Integer | Il numero della colonna in base alla quale deve essere ordinata inizialmente la tabella. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
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. var builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); var chart = builder.build();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
option | String | L'opzione da impostare. |
value | Object | Il valore da impostare. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
showRowNumberColumn(showRowNumber)
Consente di impostare se mostrare il numero di riga come prima colonna della tabella.
Il comportamento predefinito non mostra i numeri di riga.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
showRowNumber | Boolean | true se la prima colonna della tabella deve mostrare il numero di riga,
false in caso contrario. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.
useAlternatingRowStyle(alternate)
Consente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella.
Il comportamento predefinito è che le righe hanno uno stile di colore alternato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alternate | Boolean | true se gli stili di colore devono alternare, false in caso contrario. |
Ritorni
TableChartBuilder
: questo builder, utile per il concatenamento.