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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | Chart | Tworzenie wykresu. |
enablePaging(enablePaging) | TableChartBuilder | Określa, czy należy 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 na pierwszej stronie tabeli (numery stron są liczone od zera). |
enableRtlTable(rtlEnabled) | TableChartBuilder | 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. |
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 używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google. |
setDataTable(tableBuilder) | TableChartBuilder | Konfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder. |
setDataTable(table) | TableChartBuilder | Ustawia tabelę danych, która zawiera linie wykresu i etykiety osi X. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | Określa definicję widoku danych używaną na wykresie. |
setDimensions(width, height) | TableChartBuilder | Ustawia wymiary wykresu. |
setFirstRowNumber(number) | TableChartBuilder | Ustawia numer pierwszego wiersza w tabeli danych. |
setInitialSortingAscending(column) | TableChartBuilder | Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (rosnąco). |
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 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
Nazwa | Typ | Opis |
---|---|---|
enablePaging | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
pageSize | Integer | Liczba 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
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 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
Nazwa | Typ | Opis |
---|---|---|
rtlEnabled | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
enableSorting | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres 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
Nazwa | Typ | Opis |
---|---|---|
tableBuilder | DataTableBuilder | Kreator 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
Nazwa | Typ | Opis |
---|---|---|
table | DataTableSource | Tabela 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
Nazwa | Typ | Opis |
---|---|---|
dataViewDefinition | DataViewDefinition | Obiekt 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
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Szerokość wykresu w pikselach. |
height | Integer | Wysokość 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
Nazwa | Typ | Opis |
---|---|---|
number | Integer | Numer 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
Nazwa | Typ | Opis |
---|---|---|
column | Integer | Numer 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
Nazwa | Typ | Opis |
---|---|---|
column | Integer | Numer 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
Nazwa | Typ | Opis |
---|---|---|
option | String | Opcja umożliwiająca ustawienie. |
value | Object | Wartość 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
Nazwa | Typ | Opis |
---|---|---|
showRowNumber | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
alternate | Boolean | true , jeśli style kolorów powinny być zmienne, a false w przeciwnym razie. |
Powroty
TableChartBuilder
– kreator przydatny do tworzenia łańcuchów.