Konstruktor obiektów DataTable. Aby utworzyć tabelę danych, trzeba najpierw określić kolumny, a potem dodać kolejne wiersze. Przykład:
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();
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addColumn(type, label) | DataTableBuilder | Dodaje kolumnę do tabeli danych. |
addRow(values) | DataTableBuilder | Dodaje wiersz do tabeli danych. |
build() | DataTable | Kompiluje i zwraca tabelę danych. |
setValue(row, column, value) | DataTableBuilder | Ustawia określoną wartość w tabeli. |
Szczegółowa dokumentacja
addColumn(type, label)
Dodaje kolumnę do tabeli danych. Kolumny zostaną dodane od 0 do n.
Pierwsza kolumna jest często używana na wykresach z etykietami (np. etykiety osi X na wykresach liniowych lub etykiety wycinków na wykresach kołowych). Inne kolumny są często używane do podawania danych i dlatego często wymagają wartości liczbowych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
type | ColumnType | typ danych w kolumnie (liczba, ciąg znaków lub data); |
label | String | etykieta kolumny (jest używana w legendach wykresu). |
Powroty
DataTableBuilder
– ten kreator do tworzenia łańcuchów.
addRow(values)
Dodaje wiersz do tabeli danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | Object[] | określone w tej samej kolejności co kolumny. |
Powroty
DataTableBuilder
– ten kreator do tworzenia łańcuchów.
build()
setValue(row, column, value)
Ustawia określoną wartość w tabeli.
Przed dodaniem kolumny do tabeli danych można ustawić wartość. Jeśli jednak kolumna nie zostanie w którym momencie dodana, wartość będzie ignorowana.
Nie wszystkie wartości kolumn muszą być wypełnione. Brakujące dane będą traktowane jako null
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
row | Integer | indeks wiersza (pierwszy wiersz ma indeks 0) |
column | Integer | indeks kolumny (pierwsza kolumna ma indeks 0) |
value | Object | wartość komórki tabeli (powinna mieć właściwy typ dla kolumny). |
Powroty
DataTableBuilder
– ten kreator do tworzenia łańcuchów