Class DataTableBuilder

DataTableBuilder

Generatore di oggetti DataTable. Per creare una tabella di dati, devi prima specificare le colonne e poi aggiungere le righe una alla volta. Esempio:

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

Metodi

MetodoTipo restituitoBreve descrizione
addColumn(type, label)DataTableBuilderAggiunge una colonna alla tabella di dati.
addRow(values)DataTableBuilderAggiunge una riga alla tabella di dati.
build()DataTableCrea e restituisce una tabella di dati.
setValue(row, column, value)DataTableBuilderImposta un valore specifico nella tabella.

Documentazione dettagliata

addColumn(type, label)

Aggiunge una colonna alla tabella di dati. Le colonne verranno aggiunte da 0 a n.

La prima colonna viene spesso utilizzata dai grafici per le etichette (ad es. le etichette dell'asse X nei grafici a linee o le etichette delle sezioni nei grafici a torta). Le altre colonne vengono spesso utilizzate per i dati e quindi spesso richiedono valori numerici.

Parametri

NomeTipoDescrizione
typeColumnTypetipo di dati nella colonna (numero, stringa o data)
labelStringdell'etichetta della colonna (utilizzata per le leggende del grafico).

Invio

DataTableBuilder: questo generatore, per l'accodamento.


addRow(values)

Aggiunge una riga alla tabella di dati.

Parametri

NomeTipoDescrizione
valuesObject[]per la riga, specificati nello stesso ordine in cui vengono inserite le colonne.

Invio

DataTableBuilder: questo generatore, per l'accodamento.


build()

Crea e restituisce una tabella di dati.

Invio

DataTable: la tabella di dati

Lanci

Error: se la tabella di dati è vuota o non è formattata correttamente


setValue(row, column, value)

Imposta un valore specifico nella tabella.

Puoi impostare un valore prima di aggiungere la colonna alla tabella di dati. Tuttavia, a meno che la colonna non venga aggiunta a un certo punto, il valore verrà ignorato.

Non è necessario compilare tutti i valori delle colonne. Quelli mancanti verranno considerati null.

Parametri

NomeTipoDescrizione
rowIntegerl'indice riga (la prima riga ha indice 0)
columnIntegerl'indice della colonna (la prima colonna ha indice 0)
valueObjectil valore della cella della tabella (deve avere il tipo corretto per la colonna).

Invio

DataTableBuilder: questo generatore, per l'accodamento