Class LineChartBuilder

LineChartBuilder

Kreator wykresów liniowych. Więcej szczegółów znajdziesz w dokumentacji Wykresów Google.

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

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

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

const chart = chartBuilder.build();

Metody

Metoda	Zwracany typ	Krótki opis
build()	Chart	Tworzy wykres.
reverseCategories()	LineChartBuilder	Odwraca rysowanie serii na osi domeny.
setBackgroundColor(cssValue)	LineChartBuilder	Ustawia kolor tła wykresu.
setColors(cssValues)	LineChartBuilder	Ustawia kolory linii na wykresie.
setCurveStyle(style)	LineChartBuilder	Określa styl, który ma być używany w przypadku krzywych na wykresie.
setDataSourceUrl(url)	LineChartBuilder	Ustawia adres URL źródła danych, który jest używany do pobierania danych ze źródła zewnętrznego, np. z Arkuszy Google.
setDataTable(tableBuilder)	LineChartBuilder	Ustawia tabelę danych, która ma być używana na wykresie, za pomocą obiektu DataTableBuilder.
setDataTable(table)	LineChartBuilder	Ustawia tabelę danych, która zawiera linie wykresu oraz etykiety osi X.
setDataViewDefinition(dataViewDefinition)	LineChartBuilder	Określa definicję widoku danych, która ma być używana na wykresie.
setDimensions(width, height)	LineChartBuilder	Określa wymiary wykresu.
setLegendPosition(position)	LineChartBuilder	Ustawia położenie legendy względem wykresu.
setLegendTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu legendy wykresu.
setOption(option, value)	LineChartBuilder	Ustawia zaawansowane opcje tego 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ł 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ł osi pionowej.
setYAxisTitleTextStyle(textStyle)	LineChartBuilder	Ustawia styl tekstu tytułu osi pionowej.
useLogScale()	LineChartBuilder	Przekształca oś zakresu w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie).

Szczegółowa dokumentacja

build()

Tworzy wykres.

Powrót

Chart – obiekt wykresu, który można umieszczać w dokumentach i elementach interfejsu lub używać jako statycznego obrazu.

---

reverseCategories()

Odwraca rysowanie serii na osi domeny. W przypadku wykresów zakresu pionowego (np. liniowych, obszarowych lub kolumnowych) oznacza to, że oś pozioma jest rysowana od prawej do lewej. W przypadku wykresów zakresu poziomego (np. wykresów słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. W przypadku wykresów kołowych oznacza to, że wycinki są rysowane w kierunku przeciwnym do ruchu wskazówek zegara.

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

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setBackgroundColor(cssValue)

Ustawia kolor tła wykresu.

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

Parametry

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

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

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.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

Parametry

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

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setCurveStyle(style)

Określa styl, który ma być używany w przypadku krzywych na wykresie. Dozwolone style krzywych znajdziesz w sekcji CurveStyle.

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

Parametry

Nazwa	Typ	Opis
style	CurveStyle	Styl krzywych na wykresie.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

Zobacz też

• CurveStyle

---

setDataSourceUrl(url)

Ustawia adres URL źródła danych, który jest używany do pobierania danych ze źródła zewnętrznego, np. z Arkuszy Google. Jeśli podasz adres URL źródła danych i tabelę danych, adres URL źródła danych zostanie zignorowany.

Więcej informacji o wysyłaniu zapytań do źródeł danych znajdziesz w dokumentacji Wykresów Google.

Parametry

Nazwa	Typ	Opis
url	String	Adres URL źródła danych, w tym wszystkie parametry zapytania.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataTable(tableBuilder)

Ustawia tabelę danych, która ma być używana na wykresie, za pomocą obiektu DataTableBuilder. Jest to wygodna metoda ustawiania tabeli danych bez konieczności wywoływania funkcji build().

Parametry

Nazwa	Typ	Opis
tableBuilder	DataTableBuilder	narzędzie do tworzenia tabel danych, W ramach tego wywołania natychmiast tworzona jest nowa tabela danych, więc żadne dalsze aktualizacje narzędzia do tworzenia nie będą odzwierciedlone na wykresie.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataTable(table)

Ustawia tabelę danych, która zawiera linie wykresu oraz etykiety osi X. Pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Może po niej następować dowolna liczba kolumn, które muszą zawierać 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

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych, która ma być używana na wykresie.

Parametry

Nazwa	Typ	Opis
dataViewDefinition	DataViewDefinition	Obiekt definicji widoku danych, który określa widok, jaki powinien zostać utworzony na podstawie danego źródła danych na potrzeby rysowania wykresu.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setDimensions(width, height)

Określa wymiary wykresu.

Parametry

Nazwa	Typ	Opis
width	Integer	Szerokość wykresu w pikselach.
height	Integer	Wysokość wykresu w pikselach.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setLegendPosition(position)

Ustawia położenie legendy względem wykresu. Domyślnie legenda nie jest wyświetlana.

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

Parametry

Nazwa	Typ	Opis
position	Position	Położenie legendy.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setLegendTextStyle(textStyle)

Ustawia styl tekstu legendy wykresu.

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

Parametry

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu, który ma być używany w legendzie wykresu.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setOption(option, value)

Ustawia zaawansowane opcje tego 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.
const builder = Charts.newLineChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Parametry

Nazwa	Typ	Opis
option	String	Opcja do ustawienia.
value	Object	Wartość do ustawienia.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setPointStyle(style)

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

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

Parametry

Nazwa	Typ	Opis
style	PointStyle	Styl, który ma być używany w przypadku punktów na linii.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

Zobacz też

• PointStyle

---

setRange(start, end)

Ustawia zakres wykresu.

Jeśli którykolwiek punkt danych wykracza poza zakres, zakres jest rozszerzany, aby go uwzględnić.

Parametry

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

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setTitle(chartTitle)

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

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

Parametry

Nazwa	Typ	Opis
chartTitle	String	tytuł wykresu;

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setTitleTextStyle(textStyle)

Ustawia styl tekstu tytułu wykresu.

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

Parametry

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

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setXAxisTextStyle(textStyle)

Ustawia styl tekstu osi poziomej.

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

Parametry

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu, który ma być używany w przypadku tytułu osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setXAxisTitle(title)

Dodaje tytuł osi poziomej. Tytuł jest wyśrodkowany i wyświetlany pod etykietami wartości osi.

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

Parametry

Nazwa	Typ	Opis
title	String	Tytuł osi X.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

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.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parametry

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu, który ma być używany w przypadku tytułu osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setYAxisTextStyle(textStyle)

Ustawia styl tekstu osi pionowej.

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

Parametry

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu, który ma być używany w przypadku tytułu osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

setYAxisTitle(title)

Dodaje tytuł osi pionowej. Tytuł jest wyśrodkowany i wyświetlany po lewej stronie etykiet wartości.

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

Parametry

Nazwa	Typ	Opis
title	String	Tytuł osi Y.

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

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.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parametry

Nazwa	Typ	Opis
textStyle	TextStyle	Styl tekstu, który ma być używany w przypadku tytułu osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując Charts.newTextStyle().

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.

---

useLogScale()

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

Powrót

LineChartBuilder – ten konstruktor jest przydatny do łączenia.