Class ScatterChartBuilder

Kreator wykresów punktowych

Kreator wykresów punktowych Więcej informacji znajdziesz w dokumentacji Google Charts.

Poniżej przedstawiamy przykład tworzenia wykresu punktowego. Dane są importowane z arkusza kalkulacyjnego Google.

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

const chartBuilder = Charts.newScatterChart()
                         .setTitle('Adjusted GDP & U.S. Population')
                         .setXAxisTitle('U.S. Population (millions)')
                         .setYAxisTitle('Adjusted GDP ($ billions)')
                         .setDimensions(600, 500)
                         .setLegendPosition(Charts.Position.NONE)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Metody

Metoda	Zwracany typ	Krótki opis
build()	Chart	Tworzy wykres.
setBackgroundColor(cssValue)	ScatterChartBuilder	Ustawia kolor tła wykresu.
setColors(cssValues)	ScatterChartBuilder	Ustawia kolory linii na wykresie.
setDataSourceUrl(url)	ScatterChartBuilder	Ustawia adres URL źródła danych, który służy do pobierania danych z zewnętrznego źródła, np. z Arkuszy Google.
setDataTable(tableBuilder)	ScatterChartBuilder	Za pomocą klasy DataTableBuilder ustawia tabelę danych, która ma być używana na potrzeby wykresu.
setDataTable(table)	ScatterChartBuilder	Ustawia tabelę danych zawierającą linie wykresu oraz etykiety osi X.
setDataViewDefinition(dataViewDefinition)	ScatterChartBuilder	Określa definicję widoku danych używanego na wykresie.
setDimensions(width, height)	ScatterChartBuilder	Określa wymiary wykresu.
setLegendPosition(position)	ScatterChartBuilder	Określa położenie legendy względem wykresu.
setLegendTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu legendy wykresu.
setOption(option, value)	ScatterChartBuilder	Ustawia zaawansowane opcje wykresu.
setPointStyle(style)	ScatterChartBuilder	Ustawia styl punktów na linii.
setTitle(chartTitle)	ScatterChartBuilder	Ustawia tytuł wykresu.
setTitleTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu tytułu wykresu.
setXAxisLogScale()	ScatterChartBuilder	Przekształca oś poziomą w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie).
setXAxisRange(start, end)	ScatterChartBuilder	Określa zakres osi poziomej wykresu.
setXAxisTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu osi poziomej.
setXAxisTitle(title)	ScatterChartBuilder	Dodaje tytuł do osi poziomej.
setXAxisTitleTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu tytułu osi poziomej.
setYAxisLogScale()	ScatterChartBuilder	Przekształca oś pionową w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie).
setYAxisRange(start, end)	ScatterChartBuilder	Ustawia zakres osi pionowej wykresu.
setYAxisTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu osi pionowej.
setYAxisTitle(title)	ScatterChartBuilder	Dodaje tytuł do osi pionowej.
setYAxisTitleTextStyle(textStyle)	ScatterChartBuilder	Ustawia styl tekstu tytułu osi pionowej.

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 statyczny obraz.

---

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

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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"]. Element n tablicy reprezentuje kolor linii n na wykresie.

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataSourceUrl(url)

Ustawia adres URL źródła danych, który służy do pobierania danych z zewnętrznego źródła, np. z Arkuszy Google. Jeśli podasz 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 Google Charts.

Parametry

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

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataTable(tableBuilder)

Za pomocą klasy DataTableBuilder ustawia tabelę danych, która ma być używana na potrzeby wykresu. Jest to wygodna metoda ustawiania tabeli danych bez konieczności wywoływania funkcji build().

Parametry

Nazwa	Typ	Opis
tableBuilder	DataTableBuilder	Kreator tabeli danych. W ramach tego wywołania tworzona jest nowa tabela danych, więc wszelkie dalsze zmiany w kreatorze nie będą odzwierciedlane na wykresie.

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataTable(table)

Ustawia tabelę danych zawierającą linie wykresu oraz etykiety osi X. Pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Może być dowolna liczba kolumn, które muszą zawierać dane liczbowe. Każda kolumna jest wyświetlana jako osobna linijka.

Parametry

Nazwa	Typ	Opis
table	DataTableSource	Tabela danych, której chcesz użyć na wykresie.

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setDataViewDefinition(dataViewDefinition)

Określa definicję widoku danych używanego na wykresie.

Parametry

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

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setLegendPosition(position)

Określa 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	Pozycja legendy.

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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 używany w legendzie wykresu.

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setOption(option, value)

Ustawia zaawansowane opcje wykresu. Zobacz dostępne opcje tego wykresu. Ta metoda nie działa, jeśli dana opcja jest nieprawidłowa.

// Build a scatter chart with a 1-second animation duration.
const builder = Charts.newScatterChart();
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

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parametry

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

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

Zobacz też

• PointStyle

---

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

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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 funkcję Charts.newTextStyle().

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setXAxisLogScale()

Przekształca oś poziomą w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie).

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setXAxisRange(start, end)

Określa zakres osi poziomej wykresu.

Jeśli jakiekolwiek punkty danych znajdują się poza zakresem, zakres jest rozszerzany, aby obejmował te punkty danych.

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Parametry

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

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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 tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setXAxisTitle(title)

Dodaje tytuł do 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

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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 tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setYAxisLogScale()

Przekształca oś pionową w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie).

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setYAxisRange(start, end)

Ustawia zakres osi pionowej wykresu. Jeśli jakiekolwiek punkty danych znajdują się poza zakresem, zakres jest rozszerzany, aby obejmował te punkty danych.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Parametry

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

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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 tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

setYAxisTitle(title)

Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i pojawia się 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

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.

---

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 tytule osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle().

Powrót

ScatterChartBuilder – ten kreator jest przydatny do łańcuchowania.