Class TableChartBuilder

TableChartBuilder

Kreator wykresów tabelarycznych. Więcej informacji znajdziesz w dokumentacji Wykresów Google.

Oto przykład, który pokazuje, jak utworzyć wykres tabelaryczny. Dane są zaimportowane z arkusza kalkulacyjnego Google.

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

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

var chart = chartBuilder.build();

Metody

MetodaZwracany typKrótki opis
build()ChartTworzenie wykresu.
enablePaging(enablePaging)TableChartBuilderOkreśla, czy należy włączyć stronicowanie danych.
enablePaging(pageSize)TableChartBuilderWłącza stronicowanie i ustawia liczbę wierszy na każdej stronie.
enablePaging(pageSize, startPage)TableChartBuilderWłącza stronicowanie. Ustawia liczbę wierszy na każdej stronie i na pierwszej stronie tabeli (numery stron są liczone od zera).
enableRtlTable(rtlEnabled)TableChartBuilderDodaje podstawową obsługę języków pisanych od prawej do lewej (takich jak arabski czy hebrajski) przez odwrócenie kolejności kolumn tabeli, w wyniku czego kolumna 0 jest kolumną skrajną od prawej, a ostatnia od lewej.
enableSorting(enableSorting)TableChartBuilderOkreśla, czy kolumny mają być sortowane, gdy użytkownik kliknie nagłówek kolumny.
setDataSourceUrl(url)TableChartBuilderUstawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google.
setDataTable(tableBuilder)TableChartBuilderKonfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder.
setDataTable(table)TableChartBuilderUstawia tabelę danych, która zawiera linie wykresu i etykiety osi X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderOkreśla definicję widoku danych używaną na wykresie.
setDimensions(width, height)TableChartBuilderUstawia wymiary wykresu.
setFirstRowNumber(number)TableChartBuilderUstawia numer pierwszego wiersza w tabeli danych.
setInitialSortingAscending(column)TableChartBuilderUstawia indeks kolumny, według której tabela ma być początkowo sortowana (rosnąco).
setInitialSortingDescending(column)TableChartBuilderUstawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco).
setOption(option, value)TableChartBuilderUstawia zaawansowane opcje wykresu.
showRowNumberColumn(showRowNumber)TableChartBuilderOkreśla, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli.
useAlternatingRowStyle(alternate)TableChartBuilderOkreśla, czy zmienny styl kolorów jest przypisywany do wierszy nieparzystych i parzystych na wykresie tabelarycznym.

Szczegółowa dokumentacja

build()

Tworzenie wykresu.

Powroty

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


enablePaging(enablePaging)

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

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

Parametry

NazwaTypOpis
enablePagingBooleantrue, jeśli stronicowanie powinno być włączone, false w przeciwnym razie.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


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.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parametry

NazwaTypOpis
pageSizeIntegerLiczba wierszy na każdej stronie tabeli.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


enablePaging(pageSize, startPage)

Włącza stronicowanie. Ustawia liczbę wierszy na każdej stronie i na pierwszej stronie tabeli (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.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parametry

NazwaTypOpis
pageSizeIntegerLiczba wierszy na każdej stronie tabeli.
startPageIntegerPierwsza strona tabeli do wyświetlenia (numery stron są liczone od zera).

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


enableRtlTable(rtlEnabled)

Dodaje podstawową obsługę języków pisanych od prawej do lewej (takich jak arabski czy hebrajski) przez odwrócenie kolejności kolumn tabeli, w wyniku czego kolumna 0 jest kolumną skrajną od prawej, a ostatnia od lewej.

Nie ma to wpływu na indeks kolumn w danych bazowych, a jedynie na kolejność wyświetlania. Wizualizacja tabeli nie obsługuje wyświetlania pełnego dwukierunku (BiDi), nawet jeśli ta opcja jest włączona. Ta opcja jest ignorowana, jeśli włączysz stronicowanie (za pomocą opcji strony) lub jeśli w tabeli występują paski przewijania, ponieważ określone opcje wysokości i szerokości są mniejsze niż wymagany rozmiar tabeli. Domyślnym działaniem jest wyłączenie obsługi RTL.

Parametry

NazwaTypOpis
rtlEnabledBooleantrue, jeśli powinna być włączona obsługa tekstu od prawej do lewej. W przeciwnym razie false.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


enableSorting(enableSorting)

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

Jeśli sortowanie jest włączone, wiersze są automatycznie sortowane, gdy użytkownik kliknie nagłówek kolumny. Domyślnie sortowanie jest włączone.

Parametry

NazwaTypOpis
enableSortingBooleantrue, aby włączyć sortowanie, klikając nagłówki kolumn. W przeciwnym razie false.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataSourceUrl(url)

Ustawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google. Jeśli podasz adres URL źródła danych i tabelę DataTable, adres URL źródła danych zostanie zignorowany.

Więcej informacji o wykonywaniu zapytań dotyczących źródeł danych znajdziesz w dokumentacji Wykresów Google.

Parametry

NazwaTypOpis
urlStringAdres URL źródła danych wraz z parametrami zapytania.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataTable(tableBuilder)

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

Parametry

NazwaTypOpis
tableBuilderDataTableBuilderKreator tabel danych. W ramach tego wywołania natychmiast tworzona jest nowa tabela danych, więc dalsze aktualizacje kreatora nie są odzwierciedlane na wykresie.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataTable(table)

Ustawia tabelę danych, która zawiera linie wykresu i etykiety osi X. Pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Po niej może następować dowolna liczba kolumn, a wszystkie muszą mieć wartości liczbowe. Każda kolumna jest wyświetlana jako osobny wiersz.

Parametry

NazwaTypOpis
tableDataTableSourceTabela danych, która ma być używana na wykresie.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDataViewDefinition(dataViewDefinition)

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

Parametry

NazwaTypOpis
dataViewDefinitionDataViewDefinitionObiekt definicji widoku danych określający widok, który powinien pochodzić z danego źródła danych na potrzeby wykresu.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setDimensions(width, height)

Ustawia wymiary wykresu.

Parametry

NazwaTypOpis
widthIntegerSzerokość wykresu w pikselach.
heightIntegerWysokość wykresu w pikselach.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setFirstRowNumber(number)

Ustawia numer 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.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parametry

NazwaTypOpis
numberIntegerNumer pierwszego wiersza tabeli danych.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setInitialSortingAscending(column)

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

Kolumna os została posortowana w kolejności rosnącej i jest oznaczona małą strzałką, która to oznacza.

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

Parametry

NazwaTypOpis
columnIntegerNumer kolumny, według której tabela ma być początkowo sortowana.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setInitialSortingDescending(column)

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

Kolumna os została posortowana w kolejności malejącej i jest oznaczona małą strzałką, która to oznacza.

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

Parametry

NazwaTypOpis
columnIntegerNumer kolumny, według której tabela ma być początkowo sortowana.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


setOption(option, value)

Ustawia zaawansowane opcje 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.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();

Parametry

NazwaTypOpis
optionStringOpcja umożliwiająca ustawienie.
valueObjectWartość do ustawienia.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


showRowNumberColumn(showRowNumber)

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

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

Parametry

NazwaTypOpis
showRowNumberBooleantrue, jeśli pierwsza kolumna tabeli powinna zawierać numer wiersza. W przeciwnym razie false.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.


useAlternatingRowStyle(alternate)

Określa, czy zmienny styl kolorów jest przypisywany do wierszy nieparzystych i parzystych na wykresie tabelarycznym.

Domyślnym zachowaniem są wiersze ze zmiennym stylem kolorów.

Parametry

NazwaTypOpis
alternateBooleantrue, jeśli style kolorów powinny być zmienne, a false w przeciwnym razie.

Powroty

TableChartBuilder – kreator przydatny do tworzenia łańcuchów.