Class LineChartBuilder

LineChartBuilder

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

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

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

  var chartBuilder = Charts.newLineChart()
      .setTitle('Yearly Rainfall')
      .setXAxisTitle('Month')
      .setYAxisTitle('Rainfall (in)')
      .setDimensions(600, 500)
      .setCurveStyle(Charts.CurveStyle.SMOOTH)
      .setPointStyle(Charts.PointStyle.MEDIUM)
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Metody

Metoda	Zwracany typ	Krótki opis
build()	Chart	Tworzenie wykresu.
reverseCategories()	LineChartBuilder	Odwraca rysunek serii na osi domeny.
setBackgroundColor(cssValue)	LineChartBuilder	Ustawia kolor tła wykresu.
setColors(cssValues)	LineChartBuilder	Ustawia kolory linii na wykresie.
setCurveStyle(style)	LineChartBuilder	Ustawia styl krzywych na wykresie.
setDataSourceUrl(url)	LineChartBuilder	Ustawia adres URL źródła danych używany do pobierania danych ze źródła zewnętrznego, takiego jak Arkusze Google.
setDataTable(tableBuilder)	LineChartBuilder	Konfiguruje tabelę danych, która ma być używana na wykresie za pomocą DataTableBuilder.
setDataTable(table)	LineChartBuilder	Ustawia tabelę danych, która zawiera linie wykresu i etykiety osi X.
setDataViewDefinition(dataViewDefinition)	LineChartBuilder	Określa definicję widoku danych używaną na wykresie.
setDimensions(width, height)	LineChartBuilder	Ustawia wymiary wykresu.
setLegendPosition(position)	LineChartBuilder	Określa pozycję legendy względem wykresu.
setLegendTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu legendy wykresu.
setOption(option, value)	LineChartBuilder	Ustawia zaawansowane opcje wykresu.
setPointStyle(style)	LineChartBuilder	Ustawia styl punktów na linii.
setRange(start, end)	LineChartBuilder	Ustawia zakres wykresu.
setTitle(chartTitle)	LineChartBuilder	Ustawia tytuł wykresu.
setTitleTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu tytułu wykresu.
setXAxisTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu osi poziomej.
setXAxisTitle(title)	LineChartBuilder	Dodaje tytuł do osi poziomej.
setXAxisTitleTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu tytułu osi poziomej.
setYAxisTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu osi pionowej.
setYAxisTitle(title)	LineChartBuilder	Dodaje tytuł do osi pionowej.
setYAxisTitleTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu tytułu osi pionowej.
useLogScale()	LineChartBuilder	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

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

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

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

---

setCurveStyle(style)

Ustawia styl krzywych na wykresie. Dozwolone style krzywych znajdziesz na stronie CurveStyle.

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

Parametry

Nazwa	Typ	Opis
style	CurveStyle	Styl krzywych na wykresie.

Powroty

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

Zobacz też

• CurveStyle

---

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

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

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

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

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

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

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

LineChartBuilder – 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 line chart with a 1-second animation duration.
var builder = Charts.newLineChart();
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

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

---

setPointStyle(style)

Ustawia styl punktów na linii. Domyślnie punkty nie mają określonych stylów i widoczna jest tylko linia.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parametry

Nazwa	Typ	Opis
style	PointStyle	Styl używany dla punktów na linii.

Powroty

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

Zobacz też

• PointStyle

---

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

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

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

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

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

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

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

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

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

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

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