Class BarChartBuilder

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 Arkusz kalkulacyjny 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

MetodaZwracany typKrótki opis
build()ChartTworzy wykres.
reverseCategories()BarChartBuilderOdwraca rysowanie serii na osi domeny.
reverseDirection()BarChartBuilderOdwraca kierunek, w którym słupki rosną wzdłuż osi poziomej.
setBackgroundColor(cssValue)BarChartBuilderUstawia kolor tła wykresu.
setColors(cssValues)BarChartBuilderUstawia kolory linii na wykresie.
setDataSourceUrl(url)BarChartBuilderUstawia 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)BarChartBuilderKonfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder.
setDataTable(table)BarChartBuilderUstawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X.
setDataViewDefinition(dataViewDefinition)BarChartBuilderOkreśla definicję widoku danych, która będzie używana na wykresie.
setDimensions(width, height)BarChartBuilderUstawia wymiary wykresu.
setLegendPosition(position)BarChartBuilderOkreśla pozycję legendy względem wykresu.
setLegendTextStyle(textStyle)BarChartBuilderOkreśla styl tekstu legendy wykresu.
setOption(option, value)BarChartBuilderOkreśla zaawansowane opcje tego wykresu.
setRange(start, end)BarChartBuilderOkreśla zakres wykresu.
setStacked()BarChartBuilderUżywa linii skumulowanych, co oznacza, że wartości linii i słupków są skumulowane (skumulowane).
setTitle(chartTitle)BarChartBuilderOkreśla tytuł wykresu.
setTitleTextStyle(textStyle)BarChartBuilderOkreśla styl tekstu tytułu wykresu.
setXAxisTextStyle(textStyle)BarChartBuilderOkreśla styl tekstu osi poziomej.
setXAxisTitle(title)BarChartBuilderDodaje tytuł do osi poziomej.
setXAxisTitleTextStyle(textStyle)BarChartBuilderOkreśla styl tekstu tytułu na osi poziomej.
setYAxisTextStyle(textStyle)BarChartBuilderOkreśla styl tekstu osi pionowej.
setYAxisTitle(title)BarChartBuilderDodaje tytuł do osi pionowej.
setYAxisTitleTextStyle(textStyle)BarChartBuilderOkreśla styl tekstu tytułu osi pionowej.
useLogScale()BarChartBuilderPrzekształca oś zakresu w skalę logarytmiczną (wszystkie wartości muszą być dodatnie).

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 .


reverseCategories()

Odwraca rysowanie serii na osi domeny. Na wykresach pionowych (np. liniowych, wykresów warstwowych lub kolumnowych), oznacza to, że oś pozioma jest rysowana od prawej do lewej. Dla: na wykresach poziomych (np. słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. w dół. 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();

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


reverseDirection()

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

Powrót

BarChartBuilder – to kreator przydatny w przypadku ł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

NazwaTypOpis
cssValueStringWartość CSS koloru (np. "blue" lub "#00f").

Powrót

BarChartBuilder – to kreator przydatny w przypadku ł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

NazwaTypOpis
cssValuesString[]Tablica wartości CSS koloru, np. ["red", "#acf"]. N-ty element wskazuje kolor n-tej linii na wykresie.

Powrót

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

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

Powrót

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

NazwaTypOpis
tableBuilderDataTableBuilderKreator 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

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

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

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych, która będzie używana na wykresie.

Parametry

NazwaTypOpis
dataViewDefinitionDataViewDefinitionObiekt definicji widoku danych, który określa widok, który powinien być na podstawie podanego źródła danych na potrzeby rysunku.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setDimensions(width, height)

Ustawia wymiary wykresu.

Parametry

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

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setLegendPosition(position)

Określa pozycję legendy względem wykresu. Domyślnie nie ma legendy.

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

Parametry

NazwaTypOpis
positionPositionPozycja legendy.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setLegendTextStyle(textStyle)

Określa 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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany w legendzie wykresu.

Powrót

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

Parametry

NazwaTypOpis
optionStringOpcja do ustawienia.
valueObjectWartość do ustawienia.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setRange(start, end)

Określa zakres wykresu.

Jeśli jakieś punkty danych wykraczają poza zakres, zakres się powiększa, aby uwzględnić te dane. pkt.

Parametry

NazwaTypOpis
startNumberWartość najniższej linii siatki na osi zakresu.
endNumberWartość najwyższej linii siatki na osi zakresu.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setStacked()

Używa linii skumulowanych, co oznacza, że wartości linii i słupków są skumulowane (skumulowane). Domyślnie nie ma więc żadnego sposobu grupowania.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setTitle(chartTitle)

Określa tytuł wykresu. Tytuł jest wyświetlany na środku nad wykresem.

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

Parametry

NazwaTypOpis
chartTitleStringtytuł wykresu.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setTitleTextStyle(textStyle)

Określa 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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany jako tytuł wykresu. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setXAxisTextStyle(textStyle)

Określa 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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setXAxisTitle(title)

Dodaje tytuł do osi poziomej. Tytuł jest wyśrodkowany i wyświetla się pod wartością osi. etykiety.

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

Parametry

NazwaTypOpis
titleStringTytuł osi X.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setXAxisTitleTextStyle(textStyle)

Określa styl tekstu tytułu na 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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setYAxisTextStyle(textStyle)

Określa 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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setYAxisTitle(title)

Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i wyświetla się po lewej stronie wartości. etykiety.

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

Parametry

NazwaTypOpis
titleStringTytuł osi Y.

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


setYAxisTitleTextStyle(textStyle)

Określa 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

NazwaTypOpis
textStyleTextStyleStyl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.


useLogScale()

Przekształca oś zakresu w skalę logarytmiczną (wszystkie wartości muszą być dodatnie). Zakres są osią pionową dla wykresów pionowych (np. liniowe, warstwowe lub kolumnowe). oś pozioma w przypadku wykresów poziomych (np. słupkowych).

Powrót

BarChartBuilder – to kreator przydatny w przypadku łańcuchów.