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 | Tworzy wykres. |
enablePaging(enablePaging) | TableChartBuilder | Określa, czy włączyć stronicowanie danych. |
enablePaging(pageSize) | TableChartBuilder | Włącza podział na strony i ustawia liczbę wierszy na każdej stronie. |
enablePaging(pageSize, startPage) | TableChartBuilder | Włącza podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (strona liczby 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ść kolumn w tabeli, tak aby kolumna 0 była kolumną skrajnie prawą, a ostatnia kolumna była znajdujący się skrajnie po lewej stronie. |
enableSorting(enableSorting) | TableChartBuilder | Określa, czy kolumny mają być sortowane po kliknięciu przez użytkownika nagłówka. |
setDataSourceUrl(url) | TableChartBuilder | Ustawia adres URL źródła danych, które jest używane do pobierania danych ze źródła zewnętrznego, np. Google Arkusze. |
setDataTable(tableBuilder) | TableChartBuilder | Konfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder. |
setDataTable(table) | TableChartBuilder | Ustawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | Określa definicję widoku danych, która będzie używana na wykresie. |
setDimensions(width, height) | TableChartBuilder | Ustawia wymiary wykresu. |
setFirstRowNumber(number) | TableChartBuilder | Określa numer pierwszego wiersza tabeli danych. |
setInitialSortingAscending(column) | TableChartBuilder | Ustawia indeks kolumny, zgodnie z którym tabela ma być początkowo sortowana (rosnąco). |
setInitialSortingDescending(column) | TableChartBuilder | Ustawia indeks kolumny, zgodnie z którym tabela ma być początkowo sortowana (malejąco). |
setOption(option, value) | TableChartBuilder | Określa 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 z naprzemiennymi kolorami jest przypisany do nieparzystych i parzystych wierszy wykresu tabelarycznego. |
Szczegółowa dokumentacja
build()
Tworzy wykres.
Powrót
Chart
– obiekt Chart, który można umieszczać w dokumentach i elementach interfejsu albo używać jako statyczny
.
enablePaging(enablePaging)
Określa, czy włączyć stronicowanie danych.
Domyślnie strony są wyłączone. Jeśli włączone jest stronicowanie, domyślny rozmiar strony to 10.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enablePaging | Boolean | true , jeśli ma być włączone stronicowanie, false w przeciwnym razie. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
enablePaging(pageSize)
Włącza podział na strony 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. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
enablePaging(pageSize, startPage)
Włącza podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (strona liczby 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). |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku ł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ść kolumn w tabeli, tak aby kolumna 0 była kolumną skrajnie prawą, a ostatnia kolumna była znajdujący się skrajnie po lewej stronie.
Nie ma to wpływu na indeks kolumn w danych bazowych, a jedynie na kolejność wyświetlania. Wyświetlanie w pełnym dwukierunkowym języku (BiDi) nie jest obsługiwane przez wizualizację tabeli nawet przy użyciu tej opcji. Ta opcja jest ignorowana, jeśli włączysz stronicowanie (za pomocą opcji na stronie) lub tabela zawiera paski przewijania, ponieważ określone opcje wysokości i szerokości są mniejsze niż wymagany rozmiar tabeli. Domyślnie obsługa tekstu od prawej do lewej jest wyłączona.
Parametry
Nazwa | Typ | Opis |
---|---|---|
rtlEnabled | Boolean | true , jeśli ma być włączona obsługa tekstu od prawej do lewej, false
w przeciwnym razie. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
enableSorting(enableSorting)
Określa, czy kolumny mają być sortowane po kliknięciu przez użytkownika nagłówka.
Jeśli włączone jest sortowanie, po kliknięciu przez użytkownika nagłówka kolumny wiersze zostaną automatycznie posortowane. Domyślnie włączone jest sortowanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enableSorting | Boolean | true , aby włączyć sortowanie przez kliknięcie nagłówków kolumn. W przeciwnym razie false . |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDataSourceUrl(url)
Ustawia adres URL źródła danych, które jest używane do pobierania danych ze źródła zewnętrznego, np. Google Arkusze. Jeśli podany jest URL źródła danych i tabela DataTable, adres URL źródła danych jest ignorowany.
Więcej informacji o wysyłaniu 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 ze wszystkimi parametrami zapytania. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDataTable(tableBuilder)
Konfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder. Jest to wygodna metoda
do ustawienia tabeli danych bez konieczności wywoływania funkcji build()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
tableBuilder | DataTableBuilder | Kreator tabel danych. W ramach tego parametru natychmiast jest tworzona nowa tabela danych , więc dalsze aktualizacje narzędzia nie zostaną odzwierciedlone na wykresie. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDataTable(table)
Ustawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X. pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Dowolna liczba kolumn po których może następować, wszystkie muszą mieć 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
– to kreator przydatny w przypadku łańcuchów.
setDataViewDefinition(dataViewDefinition)
Określa definicję widoku danych, która będzie używana na wykresie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
dataViewDefinition | DataViewDefinition | Obiekt definicji widoku danych, który określa widok, który powinien być na podstawie podanego źródła danych na potrzeby rysunku. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku ł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. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setFirstRowNumber(number)
Określa numer pierwszego wiersza tabeli danych.
Domyślny numer wiersza 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. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setInitialSortingAscending(column)
Ustawia indeks kolumny, zgodnie z którym tabela ma być początkowo sortowana (rosnąco).
Kolumna System operacyjny jest 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. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setInitialSortingDescending(column)
Ustawia indeks kolumny, zgodnie z którym tabela ma być początkowo sortowana (malejąco).
Kolumna System operacyjny jest 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. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setOption(option, value)
Określa zaawansowane opcje tego wykresu. Zobacz dostępne opcje ten wykres. Ta metoda nie działa, jeśli dana 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 do ustawienia. |
value | Object | Wartość do ustawienia. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
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 powinna zawierać numer wiersza,
W przeciwnym razie: false . |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.
useAlternatingRowStyle(alternate)
Określa, czy styl z naprzemiennymi kolorami jest przypisany do nieparzystych i parzystych wierszy wykresu tabelarycznego.
Domyślnie wiersze mają naprzemienne kolory.
Parametry
Nazwa | Typ | Opis |
---|---|---|
alternate | Boolean | true , jeśli style kolorów powinny być naprzemienne, false w przeciwnym razie. |
Powrót
TableChartBuilder
– to kreator przydatny w przypadku łańcuchów.