Class DataTableBuilder

DataTableBuilder

Tworzenie obiektów DataTable. Tworzenie tabeli danych polega na określeniu jej kolumn, a następnie dodaniu wierszy pojedynczo. 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

MetodaZwracany typKrótki opis
addColumn(type, label)DataTableBuilderDodaje kolumnę do tabeli danych.
addRow(values)DataTableBuilderDodaje wiersz do tabeli danych.
build()DataTableTworzy i zwraca tabelę danych.
setValue(row, column, value)DataTableBuilderUstawia w tabeli określoną wartość.

Szczegółowa dokumentacja

addColumn(type, label)

Dodaje kolumnę do tabeli danych. Kolumny będą dodawane od 0 do n.

Pierwsza kolumna jest często używana przez wykresy na etykiety (np. etykiety osi X na wykresach liniowych lub etykiety segmentów na wykresach kołowych). Pozostałe kolumny są często używane do przechowywania danych, dlatego często wymagają wartości liczbowych.

Parametry

NazwaTypOpis
typeColumnTypetyp danych w kolumnie (liczba, ciąg znaków lub data);
labelStringetykietę kolumny (używana w legendzie wykresu).

Powrót

DataTableBuilder – ten kreator, do łańcuchowania.


addRow(values)

Dodaje wiersz do tabeli danych.

Parametry

NazwaTypOpis
valuesObject[]wartości wiersza, podane w tej samej kolejności, w jakiej występują kolumny;

Powrót

DataTableBuilder – ten kreator, do łańcuchowania.


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 w tabeli określoną wartość.

Wartość możesz ustawić przed dodaniem kolumny do tabeli danych. Jeśli jednak nie dodasz tej kolumny, wartość zostanie zignorowana.

Nie wszystkie wartości kolumn muszą być wypełnione. Te, których brakuje, zostaną uznane za null.

Parametry

NazwaTypOpis
rowIntegerindeks wiersza (pierwszy wiersz ma indeks 0);
columnIntegerindeks kolumny (pierwsza kolumna ma indeks 0),
valueObjectwartość komórki tabeli (powinna mieć odpowiedni typ dla kolumny);

Powrót

DataTableBuilder – ten kreator do łańcuchowania