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
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 | Imposta 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
Nome | Tipo | Descrizione |
---|---|---|
type | ColumnType | tipo di dati nella colonna (numero, stringa o data) |
label | String | della 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
Nome | Tipo | Descrizione |
---|---|---|
values | Object[] | per la riga, specificati nello stesso ordine in cui vengono inserite le colonne. |
Ritorni
DataTableBuilder
- questo generatore, per il concatenamento.
build()
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
Nome | Tipo | Descrizione |
---|---|---|
row | Integer | l'indice della riga (la prima riga ha un indice 0) |
column | Integer | l'indice della colonna (la prima colonna ha indice 0) |
value | Object | il valore della cella della tabella (deve essere del tipo corretto per la colonna). |
Ritorni
DataTableBuilder
- questo generatore, per il concatenamento