Class DataTableBuilder

DataTableBuilder

Builder di oggetti DataTable. Per creare una tabella di dati, devi innanzitutto specificare le colonne per poi aggiungerne le righe, una alla volta. Esempio:

var 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 esempio, le etichette dell'asse X sui grafici a linee o le etichette delle sezioni nei grafici a torta). Le altre colonne sono spesso utilizzate per i dati e, pertanto, spesso richiedono valori numerici.

Parametri

NomeTipoDescrizione
typeColumnTypetipo di dati nella colonna (numero, stringa o data)
labelStringdella colonna (viene utilizzata per le legende del grafico).

Ritorni

DataTableBuilder - questo generatore, per il concatenamento.


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.

Ritorni

DataTableBuilder - questo generatore, per il concatenamento.


build()

Crea e restituisce una tabella di dati.

Ritorni

DataTable: la tabella di dati

Tiri

Error: se la tabella di dati è vuota o ha un formato non valido in altro modo


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 in un determinato momento, il valore verrà ignorato.

Non tutti i valori della colonna devono essere compilati. Quelli mancanti saranno considerati null.

Parametri

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

Ritorni

DataTableBuilder - questo generatore, per il concatenamento