Class TableChartBuilder

TableChartBuilder

Narzędzie do tworzenia wykresów tabelarycznych. Więcej szczegółów znajdziesz w dokumentacji Wykresów Google.

Oto przykład pokazujący, jak utworzyć wykres tabelaryczny. 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 włączyć stronicowanie danych.
enablePaging(pageSize)	TableChartBuilder	Włącza stronicowanie i ustawia liczbę wierszy na każdej stronie.
enablePaging(pageSize, startPage)	TableChartBuilder	Włącza stronicowanie, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są oparte na zerze).
enableRtlTable(rtlEnabled)	TableChartBuilder	Dodaje podstawową obsługę języków pisanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna zerowa była najbardziej wysunięta na prawo, a ostatnia kolumna była najbardziej wysunięta 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 jest używany do pobierania danych ze źródła zewnętrznego, np. z Arkuszy Google.
setDataTable(tableBuilder)	TableChartBuilder	Ustawia tabelę danych, która ma być używana na wykresie, za pomocą obiektu DataTableBuilder.
setDataTable(table)	TableChartBuilder	Ustawia tabelę danych, która zawiera linie wykresu oraz etykiety osi X.
setDataViewDefinition(dataViewDefinition)	TableChartBuilder	Określa definicję widoku danych, która ma być używana na wykresie.
setDimensions(width, height)	TableChartBuilder	Określa wymiary wykresu.
setFirstRowNumber(number)	TableChartBuilder	Ustawia numer wiersza pierwszego wiersza w tabeli danych.
setInitialSortingAscending(column)	TableChartBuilder	Ustawia indeks kolumny, według której tabela ma być początkowo posortowana (rosnąco).
setInitialSortingDescending(column)	TableChartBuilder	Ustawia indeks kolumny, według której tabela powinna być początkowo posortowana (w kolejności malejącej).
setOption(option, value)	TableChartBuilder	Ustawia zaawansowane opcje tego wykresu.
showRowNumberColumn(showRowNumber)	TableChartBuilder	Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli.
useAlternatingRowStyle(alternate)	TableChartBuilder	Określa, czy styl kolorów naprzemiennych 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 statycznego obrazu.

---

enablePaging(enablePaging)

Określa, czy włączyć stronicowanie danych.

Domyślnie stronicowanie jest wyłączone. Jeśli stronicowanie jest włączone, domyślny rozmiar strony to 10.

Parametry

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

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

enablePaging(pageSize)

Włącza stronicowanie i ustawia liczbę wierszy na każdej 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 konstruktor jest przydatny do łączenia.

---

enablePaging(pageSize, startPage)

Włącza stronicowanie, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są oparte na zerze).

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ą oparte na zerze).

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

enableRtlTable(rtlEnabled)

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

Nie ma to wpływu na indeks kolumny w danych źródłowych, a jedynie na kolejność wyświetlania. Pełne wyświetlanie języków dwukierunkowych (BiDi) nie jest obsługiwane przez wizualizację tabeli nawet w przypadku tej opcji. Ta opcja jest ignorowana, jeśli włączysz stronicowanie (za pomocą opcji page) lub jeśli tabela ma paski przewijania, ponieważ określono opcje wysokości i szerokości mniejsze niż wymagany rozmiar tabeli. Domyślnie obsługa języków pisanych od prawej do lewej jest wyłączona.

Parametry

Nazwa	Typ	Opis
rtlEnabled	Boolean	true jeśli ma być włączona obsługa pisma od prawej do lewej, false w przeciwnym razie.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

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 włączyć sortowanie przez klikanie nagłówków kolumn, false w przeciwnym razie.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataSourceUrl(url)

Ustawia adres URL źródła danych, który jest używany do pobierania danych ze źródła zewnętrznego, np. z Arkuszy Google. Jeśli podasz adres 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 Wykresów Google.

Parametry

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

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataTable(tableBuilder)

Ustawia tabelę danych, która ma być używana na wykresie, za pomocą obiektu DataTableBuilder. Jest to wygodna metoda ustawiania tabeli danych bez konieczności wywoływania funkcji build().

Parametry

Nazwa	Typ	Opis
tableBuilder	DataTableBuilder	narzędzie do tworzenia tabel danych, W ramach tego wywołania natychmiast tworzona jest nowa tabela danych, więc żadne dalsze aktualizacje narzędzia do tworzenia nie będą odzwierciedlone na wykresie.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataTable(table)

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

Parametry

Nazwa	Typ	Opis
table	DataTableSource	Tabela danych, która ma być używana na wykresie.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych, która ma być używana na wykresie.

Parametry

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

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

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 konstruktor jest przydatny do łączenia.

---

setFirstRowNumber(number)

Ustawia numer wiersza 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 konstruktor jest przydatny do łączenia.

---

setInitialSortingAscending(column)

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

Kolumna jest posortowana w kolejności rosnącej i jest 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 sortowana.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setInitialSortingDescending(column)

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

Kolumna jest posortowana malejąco i jest 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 sortowana.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setOption(option, value)

Ustawia zaawansowane opcje tego wykresu. Zobacz dostępne opcje tego wykresu. Ta metoda nie działa, jeśli podana 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 konstruktor jest przydatny do łączenia.

---

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.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.

---

useAlternatingRowStyle(alternate)

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

Domyślnie wiersze mają styl z naprzemiennymi kolorami.

Parametry

Nazwa	Typ	Opis
alternate	Boolean	true – jeśli style kolorów mają być naprzemienne, false – w przeciwnym razie.

Powrót

TableChartBuilder – ten konstruktor jest przydatny do łączenia.