Kreator obiektów DataTable. Tworzenie tabeli danych polega na najpierw określeniu jej kolumn, a a potem dodawać wiersze pojedynczo. 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 | Tworzy i zwraca tabelę danych. |
setValue(row, column, value) | DataTableBuilder | Ustawia konkretną 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 jako etykiet (np. etykiety na osi X w wierszu wykresów ani etykiet wycinków na wykresach kołowych). Inne kolumny są często używane do wyświetlania danych, więc 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 (używana w legendach wykresu). |
Powrót
DataTableBuilder
– narzędzie do tworzenia łańcuchów.
addRow(values)
Dodaje wiersz do tabeli danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | Object[] | wartości w wierszu określonych w tej samej kolejności, w jakiej są wprowadzane kolumny. |
Powrót
DataTableBuilder
– narzędzie do tworzenia łańcuchów.
build()
setValue(row, column, value)
Ustawia konkretną wartość w tabeli.
Przed dodaniem kolumny do tabeli danych możesz ustawić wartość. Jeśli jednak kolumna zostanie w którymś momencie dodany, wartość zostanie zignorowana.
Nie wszystkie wartości kolumn muszą być wypełnione. Te brakujące zostaną uznane za 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ć odpowiedni typ dla kolumny). |
Powrót
DataTableBuilder
– ten kreator do tworzenia łańcuchów