Class DataTableBuilder

DataTableBuilder

Konstruktor obiektów DataTable. Tworzenie tabeli danych polega na określeniu najpierw jej kolumn, a potem dodawaniu wierszy, po jednym na raz. Przykład:

const 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 w zakresie od 0 do n.

Pierwsza kolumna jest często używana przez wykresy jako etykiety (np. etykiety osi X na wykresach liniowych lub etykiety wycinków na wykresach kołowych). Pozostałe kolumny są często używane do przechowywania danych, 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 (używana w legendach wykresów);

Powrót

DataTableBuilder – ten kreator do łączenia.

---

addRow(values)

Dodaje wiersz do tabeli danych.

Parametry

Nazwa	Typ	Opis
values	Object[]	wartości wiersza podane w tej samej kolejności co kolumny.

Powrót

DataTableBuilder – ten kreator do łączenia.

---

build()

Tworzy i zwraca tabelę danych.

Powrót

DataTable – tabela danych;

Rzuty

Error – jeśli tabela danych jest pusta lub ma nieprawidłowy format.

---

setValue(row, column, value)

Ustawia konkretną wartość w tabeli.

Wartość możesz ustawić przed dodaniem kolumny do tabeli danych. Jeśli jednak kolumna nie zostanie w pewnym momencie dodana, wartość zostanie zignorowana.

Nie musisz wypełniać wszystkich wartości kolumn. Brakujące wartości 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 konstruktor do łączenia