Builder di oggetti DataTable. Per creare una tabella di dati, devi innanzitutto specificarne le colonne e e aggiungendone 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
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addColumn(type, label) | DataTableBuilder | Aggiunge una colonna alla tabella di dati. |
addRow(values) | DataTableBuilder | Aggiunge una riga alla tabella di dati. |
build() | DataTable | Crea e restituisce una tabella di dati. |
setValue(row, column, value) | DataTableBuilder | Consente di impostare 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 sulla linea grafici o le etichette delle sezioni nei grafici a torta). Le altre colonne vengono spesso utilizzate per i dati e, di conseguenza, spesso richiedono valori numerici.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | ColumnType | tipo di dati nella colonna (numero, stringa o data) |
label | String | dell'etichetta della colonna (utilizzata per le legende del grafico). |
Invio
DataTableBuilder
: questo builder, per il concatenamento.
addRow(values)
Aggiunge una riga alla tabella di dati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
values | Object[] | per la riga, specificati nello stesso ordine in cui vengono inserite le colonne. |
Invio
DataTableBuilder
: questo builder, per il concatenamento.
build()
setValue(row, column, value)
Consente di impostare un valore specifico nella tabella.
Puoi impostare un valore prima di aggiungere la colonna alla tabella di dati. Tuttavia, a meno che la colonna viene aggiunto a un certo punto, il valore verrà ignorato.
Non tutti i valori della colonna devono essere compilati. Quelli mancanti saranno considerati null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Integer | l'indice della riga (la prima riga ha indice 0) |
column | Integer | l'indice della colonna (la prima colonna ha indice 0) |
value | Object | il valore della cella della tabella (deve avere il tipo corretto per la colonna). |
Invio
DataTableBuilder
: questo builder, per il concatenamento