Ta strona została przetłumaczona przez Cloud Translation API.

Class BarChartBuilder

Narzędzie do tworzenia wykresów słupkowych. Więcej informacji znajdziesz w dokumentacji Wykresów Google.

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

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

 var chartBuilder = Charts.newBarChart()
     .setTitle('Top Grossing Films in US and Canada')
     .setXAxisTitle('USD')
     .setYAxisTitle('Film')
     .setDimensions(600, 500)
     .setLegendPosition(Charts.Position.BOTTOM)
     .setDataSourceUrl(dataSourceUrl);

 var chart = chartBuilder.build();

Metody

Metoda	Zwracany typ	Krótki opis
`build()`	`Chart`	Tworzenie wykresu.
`reverseCategories()`	`BarChartBuilder`	Odwraca rysunek serii na osi domeny.
`reverseDirection()`	`BarChartBuilder`	Odwraca kierunek, w którym paski rosną wzdłuż osi poziomej.
`setBackgroundColor(cssValue)`	`BarChartBuilder`	Ustawia kolor tła wykresu.
`setColors(cssValues)`	`BarChartBuilder`	Ustawia kolory linii na wykresie.
`setDataSourceUrl(url)`	`BarChartBuilder`	Ustawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google.
`setDataTable(tableBuilder)`	`BarChartBuilder`	Konfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder.
`setDataTable(table)`	`BarChartBuilder`	Ustawia tabelę danych, która zawiera linie wykresu i etykiety osi X.
`setDataViewDefinition(dataViewDefinition)`	`BarChartBuilder`	Określa definicję widoku danych używaną na wykresie.
`setDimensions(width, height)`	`BarChartBuilder`	Ustawia wymiary wykresu.
`setLegendPosition(position)`	`BarChartBuilder`	Określa pozycję legendy względem wykresu.
`setLegendTextStyle(textStyle)`	`BarChartBuilder`	Ustawia styl tekstu legendy wykresu.
`setOption(option, value)`	`BarChartBuilder`	Ustawia zaawansowane opcje wykresu.
`setRange(start, end)`	`BarChartBuilder`	Ustawia zakres wykresu.
`setStacked()`	`BarChartBuilder`	Stosuje wykres skumulowany, co oznacza, że wartości linii i słupków są skumulowane.
`setTitle(chartTitle)`	`BarChartBuilder`	Ustawia tytuł wykresu.
`setTitleTextStyle(textStyle)`	`BarChartBuilder`	Ustawia styl tekstu tytułu wykresu.
`setXAxisTextStyle(textStyle)`	`BarChartBuilder`	Ustawia styl tekstu osi poziomej.
`setXAxisTitle(title)`	`BarChartBuilder`	Dodaje tytuł do osi poziomej.
`setXAxisTitleTextStyle(textStyle)`	`BarChartBuilder`	Ustawia styl tekstu tytułu osi poziomej.
`setYAxisTextStyle(textStyle)`	`BarChartBuilder`	Ustawia styl tekstu osi pionowej.
`setYAxisTitle(title)`	`BarChartBuilder`	Dodaje tytuł do osi pionowej.
`setYAxisTitleTextStyle(textStyle)`	`BarChartBuilder`	Ustawia styl tekstu tytułu osi pionowej.
`useLogScale()`	`BarChartBuilder`	Zmienia oś zakresu na skalę logarytmiczną (wymaga, by wszystkie wartości były dodatnie).

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.

`reverseCategories()`

Odwraca rysunek serii na osi domeny. W przypadku wykresów pionowych (np. liniowych, warstwowych lub kolumnowych) oznacza to, że oś pozioma jest rysowana od prawej do lewej. W przypadku wykresów poziomych (np. słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. W przypadku wykresów kołowych wycinki są rysowane w lewo.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Powroty

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

`reverseDirection()`

Odwraca kierunek, w którym paski rosną wzdłuż osi poziomej. Domyślnie wartości rosną od lewej do prawej. Wywołanie tej metody powoduje, że rosną one od prawej do lewej.

Powroty

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

`setBackgroundColor(cssValue)`

Ustawia kolor tła wykresu.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parametry

Nazwa	Typ	Opis
`cssValue`	`String`	Wartość CSS koloru (np. `"blue"` lub `"#00f"`).

Powroty

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

`setColors(cssValues)`

Ustawia kolory linii na wykresie.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parametry

Nazwa	Typ	Opis
`cssValues`	`String[]`	Tablica wartości CSS kolorów, np. `["red", "#acf"]`. N-ty element tablicy reprezentuje kolor n-tej linii na wykresie.

Powroty

BarChartBuilder – 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

BarChartBuilder – 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

BarChartBuilder – 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

BarChartBuilder – 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

BarChartBuilder – 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

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

`setLegendPosition(position)`

Określa pozycję legendy względem wykresu. Domyślnie legenda nie jest wyświetlana.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parametry

Nazwa	Typ	Opis
`position`	`Position`	Pozycja legendy.

Powroty

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

`setLegendTextStyle(textStyle)`

Ustawia styl tekstu legendy wykresu.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w legendzie wykresu.

Powroty

BarChartBuilder – 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 bar chart with a 1-second animation duration.
var builder = Charts.newBarChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Parametry

Nazwa	Typ	Opis
`option`	`String`	Opcja umożliwiająca ustawienie.
`value`	`Object`	Wartość do ustawienia.

Powroty

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

`setRange(start, end)`

Ustawia zakres wykresu.

Jeśli jakieś punkty danych wykraczają poza zakres, zakres jest poszerzany, by uwzględnić te punkty.

Parametry

Nazwa	Typ	Opis
`start`	`Number`	Wartość najniższej linii siatki na osi zakresu.
`end`	`Number`	Wartość najwyższej linii siatki na osi zakresu.

Powroty

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

`setStacked()`

Stosuje wykres skumulowany, co oznacza, że wartości linii i słupków są skumulowane. Domyślnie nie ma skumulowania się.

Powroty

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

`setTitle(chartTitle)`

Ustawia tytuł wykresu. Tytuł jest wyśrodkowany nad wykresem.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parametry

Nazwa	Typ	Opis
`chartTitle`	`String`	tytuł wykresu.

Powroty

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

`setTitleTextStyle(textStyle)`

Ustawia styl tekstu tytułu wykresu.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w tytule wykresu. Obiekt `TextStyleBuilder` możesz utworzyć, wywołując `Charts.newTextStyle()`.

Powroty

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

`setXAxisTextStyle(textStyle)`

Ustawia styl tekstu osi poziomej.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w tytule osi poziomej. Obiekt `TextStyleBuilder` możesz utworzyć, wywołując `Charts.newTextStyle()`.

Powroty

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

`setXAxisTitle(title)`

Dodaje tytuł do osi poziomej. Tytuł jest wyśrodkowany i pojawia się pod etykietami wartości osi.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Parametry

Nazwa	Typ	Opis
`title`	`String`	Tytuł osi X.

Powroty

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

`setXAxisTitleTextStyle(textStyle)`

Ustawia styl tekstu tytułu osi poziomej.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w tytule osi poziomej. Obiekt `TextStyleBuilder` możesz utworzyć, wywołując `Charts.newTextStyle()`.

Powroty

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

`setYAxisTextStyle(textStyle)`

Ustawia styl tekstu osi pionowej.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w tytule osi poziomej. Obiekt `TextStyleBuilder` możesz utworzyć, wywołując `Charts.newTextStyle()`.

Powroty

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

`setYAxisTitle(title)`

Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i wyświetla się na lewo od etykiet wartości.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Parametry

Nazwa	Typ	Opis
`title`	`String`	Tytuł osi Y.

Powroty

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

`setYAxisTitleTextStyle(textStyle)`

Ustawia styl tekstu tytułu osi pionowej.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parametry

Nazwa	Typ	Opis
`textStyle`	`TextStyle`	Styl tekstu używany w tytule osi poziomej. Obiekt `TextStyleBuilder` możesz utworzyć, wywołując `Charts.newTextStyle()`.

Powroty

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

`useLogScale()`

Zmienia oś zakresu na skalę logarytmiczną (wymaga, by wszystkie wartości były dodatnie). Oś zakresu to oś pionowa wykresów pionowych (np. liniowych, warstwowych i kolumnowych) i oś pozioma w przypadku wykresów poziomych (np. słupkowych).

Powroty

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