Class ScatterChartBuilder

ScatterChartBuilder

Конструктор для точечных диаграмм. Для получения более подробной информации см. документацию Google Charts .

Вот пример, демонстрирующий построение точечной диаграммы. Данные импортированы из электронной таблицы 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();

Методы

Метод Тип возвращаемого значения Краткое описание
build() Chart Создаёт диаграмму.
set Background Color(cssValue) Scatter Chart Builder Задает цвет фона для диаграммы.
set Colors(cssValues) Scatter Chart Builder Задает цвета для линий на диаграмме.
set Data Source Url(url) Scatter Chart Builder Задает URL-адрес источника данных, который используется для получения данных из внешнего источника, например, Google Таблиц.
set Data Table(tableBuilder) Scatter Chart Builder Задает таблицу данных, используемую для построения диаграммы, с помощью DataTableBuilder.
set Data Table(table) Scatter Chart Builder Задает таблицу данных, содержащую линии для диаграммы, а также подписи к оси X.
set Data View Definition(dataViewDefinition) Scatter Chart Builder Задает определение представления данных, которое будет использоваться для диаграммы.
set Dimensions(width, height) Scatter Chart Builder Задает размеры диаграммы.
set Legend Position(position) Scatter Chart Builder Задает положение легенды относительно диаграммы.
set Legend Text Style(textStyle) Scatter Chart Builder Задает стиль текста легенды диаграммы.
set Option(option, value) Scatter Chart Builder Задает дополнительные параметры для этой диаграммы.
set Point Style(style) Scatter Chart Builder Задает стиль для точек на линии.
set Title(chartTitle) Scatter Chart Builder Задает заголовок диаграммы.
set Title Text Style(textStyle) Scatter Chart Builder Задает стиль текста заголовка диаграммы.
set XAxis Log Scale() Scatter Chart Builder Преобразует горизонтальную ось в логарифмическую шкалу (требует, чтобы все значения были положительными).
set XAxis Range(start, end) Scatter Chart Builder Задает диапазон для горизонтальной оси диаграммы.
set XAxis Text Style(textStyle) Scatter Chart Builder Задает стиль текста по горизонтальной оси.
set XAxis Title(title) Scatter Chart Builder Добавляет заголовок к горизонтальной оси.
set XAxis Title Text Style(textStyle) Scatter Chart Builder Задает стиль текста заголовка по горизонтальной оси.
set YAxis Log Scale() Scatter Chart Builder Преобразует вертикальную ось в логарифмическую шкалу (требует, чтобы все значения были положительными).
set YAxis Range(start, end) Scatter Chart Builder Задает диапазон для вертикальной оси диаграммы.
set YAxis Text Style(textStyle) Scatter Chart Builder Задает стиль текста по вертикальной оси.
set YAxis Title(title) Scatter Chart Builder Добавляет заголовок к вертикальной оси.
set YAxis Title Text Style(textStyle) Scatter Chart Builder Задает стиль текста заголовка по вертикальной оси.

Подробная документация

build()

Создаёт диаграмму.

Возвращаться

Chart — объект типа Chart, который можно встраивать в документы, элементы пользовательского интерфейса или использовать в качестве статического изображения.

setBackgroundColor(cssValue)

Задает цвет фона для диаграммы.

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

Параметры

Имя Тип Описание
css Value String CSS-значение для цвета (например, "blue" или "#00f" ).

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setColors(cssValues)

Задает цвета для линий на диаграмме.

// 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']);

Параметры

Имя Тип Описание
css Values String[] Массив значений CSS для цветов, например, ["red", "#acf"] . n-й элемент массива представляет цвет n-й линии на графике.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setDataSourceUrl(url)

Задает URL-адрес источника данных, используемого для получения данных из внешнего источника, например, Google Sheets. Если указаны URL-адрес источника данных и объект DataTable, URL-адрес источника данных игнорируется.

Для получения более подробной информации о запросах к источникам данных ознакомьтесь с документацией Google Charts .

Параметры

Имя Тип Описание
url String URL-адрес источника данных, включая любые параметры запроса.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setDataTable(tableBuilder)

Задает таблицу данных для построения диаграммы с помощью DataTableBuilder. Это удобный способ задать таблицу данных без необходимости вызова build() .

Параметры

Имя Тип Описание
table Builder Data Table Builder Конструктор таблиц данных. В рамках этого вызова мгновенно создается новая таблица данных, поэтому любые дальнейшие обновления конструктора не будут отражены в диаграмме.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setDataTable(table)

Задает таблицу данных, содержащую линии для диаграммы, а также подписи оси X. Первый столбец должен быть строковым и содержать подписи горизонтальной оси. Далее может следовать любое количество столбцов, все они должны быть числовыми. Каждый столбец отображается в виде отдельной строки.

Параметры

Имя Тип Описание
table Data Table Source Таблица данных, используемая для построения диаграммы.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setDataViewDefinition(dataViewDefinition)

Задает определение представления данных, которое будет использоваться для диаграммы.

Параметры

Имя Тип Описание
data View Definition Data View Definition Объект определения представления данных, который определяет представление, которое должно быть получено из заданного источника данных для построения диаграммы.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setDimensions(width, height)

Задает размеры диаграммы.

Параметры

Имя Тип Описание
width Integer Ширина диаграммы в пикселях.
height Integer Высота диаграммы в пикселях.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setLegendPosition(position)

Задает положение легенды относительно диаграммы. По умолчанию легенда отсутствует.

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

Параметры

Имя Тип Описание
position Position Положение легенды.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setLegendTextStyle(textStyle)

Задает стиль текста легенды диаграммы.

// 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);

Параметры

Имя Тип Описание
text Style Text Style Стиль текста, используемый для легенды диаграммы.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setOption(option, value)

Задает дополнительные параметры для этой диаграммы. См. доступные параметры для этой диаграммы . Этот метод не имеет эффекта, если указанный параметр недействителен.

// Build a scatter chart with a 1-second animation duration.
const builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Параметры

Имя Тип Описание
option String Возможность настройки.
value Object Значение, которое нужно установить.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setPointStyle(style)

Задает стиль для точек на линии. По умолчанию точки не имеют каких-либо особых стилей, и видна только линия.

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

Параметры

Имя Тип Описание
style Point Style Стиль, используемый для обозначения точек на линии.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

См. также

setTitle(chartTitle)

Задает заголовок диаграммы. Заголовок отображается по центру над диаграммой.

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

Параметры

Имя Тип Описание
chart Title String заголовок диаграммы.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setTitleTextStyle(textStyle)

Задает стиль текста заголовка диаграммы.

// 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);

Параметры

Имя Тип Описание
text Style Text Style Стиль текста, используемый для заголовка диаграммы. Вы можете создать объект Text Style Builder , вызвав метод Charts.newTextStyle() .

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setXAxisLogScale()

Преобразует горизонтальную ось в логарифмическую шкалу (требует, чтобы все значения были положительными).

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setXAxisRange(start, end)

Задает диапазон для горизонтальной оси диаграммы.

Если какие-либо точки данных выходят за пределы диапазона, диапазон расширяется, чтобы включить эти точки данных. 

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

Параметры

Имя Тип Описание
start Number Значение для самой нижней линии сетки по горизонтальной оси.
end Number Значение для самой верхней линии сетки по горизонтальной оси.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setXAxisTextStyle(textStyle)

Задает стиль текста по горизонтальной оси. 

// 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);

Параметры

Имя Тип Описание
text Style Text Style Стиль текста, используемый для заголовка горизонтальной оси. Вы можете создать объект Text Style Builder , вызвав метод Charts.newTextStyle() .

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setXAxisTitle(title)

Добавляет заголовок к горизонтальной оси. Заголовок центрируется и отображается под метками значений оси. 

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

Параметры

Имя Тип Описание
title String Заголовок для оси X.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setXAxisTitleTextStyle(textStyle)

Задает стиль текста заголовка по горизонтальной оси. 

// 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);

Параметры

Имя Тип Описание
text Style Text Style Стиль текста, используемый для заголовка горизонтальной оси. Вы можете создать объект Text Style Builder , вызвав метод Charts.newTextStyle() .

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setYAxisLogScale()

Преобразует вертикальную ось в логарифмическую шкалу (требует, чтобы все значения были положительными).

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setYAxisRange(start, end)

Задает диапазон для вертикальной оси диаграммы. Если какие-либо точки данных выходят за пределы диапазона, диапазон расширяется, чтобы включить эти точки данных. 

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

Параметры

Имя Тип Описание
start Number Значение для самой нижней линии сетки по вертикальной оси.
end Number Значение для самой верхней линии сетки по вертикальной оси.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setYAxisTextStyle(textStyle)

Задает стиль текста по вертикальной оси. 

// 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);

Параметры

Имя Тип Описание
text Style Text Style Стиль текста, используемый для заголовка горизонтальной оси. Вы можете создать объект Text Style Builder , вызвав метод Charts.newTextStyle() .

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setYAxisTitle(title)

Добавляет заголовок к вертикальной оси. Заголовок центрируется и отображается слева от меток значений. 

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

Параметры

Имя Тип Описание
title String Заголовок для оси Y.

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.

setYAxisTitleTextStyle(textStyle)

Задает стиль текста заголовка по вертикальной оси. 

// 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);

Параметры

Имя Тип Описание
text Style Text Style Стиль текста, используемый для заголовка горизонтальной оси. Вы можете создать объект Text Style Builder , вызвав метод Charts.newTextStyle() .

Возвращаться

ScatterChartBuilder — Этот конструктор полезен для построения цепочек диаграмм.