Class TableChartBuilder

TabelaDane do wykresuBudowa

Tworzenie wykresów tabeli. Więcej informacji znajdziesz w dokumentacji Google Charts.

Poniżej znajdziesz przykładowy sposób tworzenia wykresu tabelarycznego. Dane są importowane z arkusza kalkulacyjnego Google.

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Metody

Metoda	Zwracany typ	Krótki opis
build()	Chart	Tworzy wykres.
enablePaging(enablePaging)	TableChartBuilder	Określa, czy należy włączyć przewijanie danych.
enablePaging(pageSize)	TableChartBuilder	Włącza podział na strony i ustala liczbę wierszy na stronie.
enablePaging(pageSize, startPage)	TableChartBuilder	Umożliwia podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są liczone od zera).
enableRtlTable(rtlEnabled)	TableChartBuilder	Dodaje podstawową obsługę języków zapisywanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna 0 była kolumną najbardziej na prawo, a ostatnia kolumna – najbardziej na lewo.
enableSorting(enableSorting)	TableChartBuilder	Określa, czy kolumny mają być sortowane, gdy użytkownik kliknie nagłówek kolumny.
setDataSourceUrl(url)	TableChartBuilder	Ustawia adres URL źródła danych, który służy do pobierania danych z zewnętrznego źródła, np. z Arkuszy Google.
setDataTable(tableBuilder)	TableChartBuilder	Za pomocą klasy DataTableBuilder ustawia tabelę danych, która ma być używana na potrzeby wykresu.
setDataTable(table)	TableChartBuilder	Ustawia tabelę danych zawierającą linie wykresu oraz etykiety osi X.
setDataViewDefinition(dataViewDefinition)	TableChartBuilder	Określa definicję widoku danych używanego na wykresie.
setDimensions(width, height)	TableChartBuilder	Określa wymiary wykresu.
setFirstRowNumber(number)	TableChartBuilder	Ustawia numer wiersza dla pierwszego wiersza w tabeli danych.
setInitialSortingAscending(column)	TableChartBuilder	Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (w kolejności rosnącej).
setInitialSortingDescending(column)	TableChartBuilder	Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco).
setOption(option, value)	TableChartBuilder	Ustawia zaawansowane opcje wykresu.
showRowNumberColumn(showRowNumber)	TableChartBuilder	Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli.
useAlternatingRowStyle(alternate)	TableChartBuilder	Określa, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli.

Szczegółowa dokumentacja

build()

Tworzy wykres.

Powrót

Chart – obiekt wykresu, który można umieszczać w dokumentach i elementach interfejsu lub używać jako statyczny obraz.

---

enablePaging(enablePaging)

Określa, czy należy włączyć przewijanie danych.

Domyślnie paging jest wyłączony. Jeśli masz włączone podział na strony, domyślny rozmiar strony to 10.

Parametry

Nazwa	Typ	Opis
enablePaging	Boolean	true, jeśli ma być włączone przewijanie, a w przeciwnym razie false.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

enablePaging(pageSize)

Włącza podział na strony i ustala liczbę wierszy na stronie.

Domyślny rozmiar strony to 10.

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Parametry

Nazwa	Typ	Opis
pageSize	Integer	Liczba wierszy na każdej stronie tabeli.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

enablePaging(pageSize, startPage)

Umożliwia podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są liczone od zera).

Domyślny rozmiar strony to 10, a domyślna strona początkowa to 0.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parametry

Nazwa	Typ	Opis
pageSize	Integer	Liczba wierszy na każdej stronie tabeli.
startPage	Integer	Pierwsza strona tabeli do wyświetlenia (numery stron są liczone od 0).

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

enableRtlTable(rtlEnabled)

Dodaje podstawową obsługę języków zapisywanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna 0 była kolumną najbardziej na prawo, a ostatnia kolumna – najbardziej na lewo.

Nie wpływa to na indeks kolumny w podstawowych danych, tylko na kolejność wyświetlania. Wizualizacja tabeli nie obsługuje pełnego dwukierunkowego (BiDi) wyświetlania języka, nawet z tą opcją. Ta opcja jest ignorowana, jeśli włączysz przewijanie (za pomocą opcji strony) lub jeśli tabela ma paski przewijania, ponieważ masz ustawione opcje wysokości i szerokości mniejsze niż wymagany rozmiar tabeli. Domyślnie obsługa RTL jest wyłączona.

Parametry

Nazwa	Typ	Opis
rtlEnabled	Boolean	true, jeśli ma być włączone wyświetlanie od prawej do lewej, falsew przeciwnym razie.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

enableSorting(enableSorting)

Określa, czy kolumny mają być sortowane, gdy użytkownik kliknie nagłówek kolumny.

Jeśli sortowanie jest włączone, po kliknięciu nagłówka kolumny wiersze są automatycznie sortowane. Domyślnie sortowanie jest włączone.

Parametry

Nazwa	Typ	Opis
enableSorting	Boolean	true, aby umożliwić sortowanie przez klikanie nagłówków kolumn, false w przeciwnym razie.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataSourceUrl(url)

Ustawia adres URL źródła danych, który służy do pobierania danych z zewnętrznego źródła, np. z Arkuszy Google. Jeśli podasz URL źródła danych i tabelę danych, adres URL źródła danych zostanie zignorowany.

Więcej informacji o wysyłaniu zapytań do źródeł danych znajdziesz w dokumentacji Google Charts.

Parametry

Nazwa	Typ	Opis
url	String	Adres URL źródła danych, w tym parametry zapytania.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataTable(tableBuilder)

Za pomocą klasy DataTableBuilder ustawia tabelę danych, która ma być używana na potrzeby wykresu. Jest to wygodna metoda ustawiania tabeli danych bez konieczności wywoływania funkcji build().

Parametry

Nazwa	Typ	Opis
tableBuilder	DataTableBuilder	Kreator tabeli danych. W ramach tego wywołania tworzona jest nowa tabela danych, więc wszelkie dalsze zmiany w kreatorze nie będą odzwierciedlane na wykresie.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataTable(table)

Ustawia tabelę danych zawierającą linie wykresu oraz etykiety osi X. Pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Może być dowolna liczba kolumn, które muszą zawierać dane liczbowe. Każda kolumna jest wyświetlana jako osobna linijka.

Parametry

Nazwa	Typ	Opis
table	DataTableSource	Tabela danych, której chcesz użyć na wykresie.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych używanego na wykresie.

Parametry

Nazwa	Typ	Opis
dataViewDefinition	DataViewDefinition	Obiekt definicji widoku danych, który definiuje widok, który powinien zostać utworzony na podstawie danego źródła danych na potrzeby rysowania wykresu.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDimensions(width, height)

Określa wymiary wykresu.

Parametry

Nazwa	Typ	Opis
width	Integer	Szerokość wykresu w pikselach.
height	Integer	Wysokość wykresu w pikselach.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setFirstRowNumber(number)

Ustawia numer wiersza dla pierwszego wiersza w tabeli danych.

Domyślny numer pierwszego wiersza to 1.

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parametry

Nazwa	Typ	Opis
number	Integer	Numer pierwszego wiersza w tabeli danych.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setInitialSortingAscending(column)

Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (w kolejności rosnącej).

Kolumna jest posortowana rosnąco i oznaczona małą strzałką.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parametry

Nazwa	Typ	Opis
column	Integer	Numer kolumny, według której tabela ma być początkowo posortowana.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setInitialSortingDescending(column)

Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco).

Kolumna jest posortowana malejąco i oznaczona małą strzałką.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parametry

Nazwa	Typ	Opis
column	Integer	Numer kolumny, według której tabela ma być początkowo posortowana.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setOption(option, value)

Ustawia zaawansowane opcje wykresu. Zobacz dostępne opcje tego wykresu. Ta metoda nie działa, jeśli dana opcja jest nieprawidłowa.

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

Parametry

Nazwa	Typ	Opis
option	String	Opcja do ustawienia.
value	Object	Wartość do ustawienia.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

showRowNumberColumn(showRowNumber)

Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli.

Domyślnie numery wierszy nie są wyświetlane.

Parametry

Nazwa	Typ	Opis
showRowNumber	Boolean	true, jeśli pierwsza kolumna tabeli ma zawierać numer wiersza,false w przeciwnym razie – false.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

useAlternatingRowStyle(alternate)

Określa, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli.

Domyślnie wiersze mają naprzemiennie kolory.

Parametry

Nazwa	Typ	Opis
alternate	Boolean	true, jeśli style kolorów mają się naprzemiennie pojawiać, false w przeciwnym razie.

Powrót

TableChartBuilder – ten kreator jest przydatny do łańcuchowania.