Class 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, который можно внедрить в документы, элементы пользовательского интерфейса или использовать в качестве статического изображения.


set Background Color(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" ).

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Colors(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-й линии диаграммы.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Data Source Url(url)

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

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Data Table(tableBuilder)

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Data Table(table)

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Data View Definition(dataViewDefinition)

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Dimensions(width, height)

Устанавливает размеры диаграммы.

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Legend Position(position)

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

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Legend Text Style(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 Стиль текста, используемый для легенды диаграммы.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Option(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 Значение, которое необходимо установить.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Point Style(style)

Устанавливает стиль точек на линии. По умолчанию точки не имеют определенных стилей, видна только линия.

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.

См. также


set Title(chartTitle)

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

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

Параметры

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set Title Text Style(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() .

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set XAxis Log Scale()

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set XAxis Range(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 Значение самой высокой линии сетки горизонтальной оси.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set XAxis Text Style(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() .

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set XAxis Title(title)

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

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

Параметры

Имя Тип Описание
title String Название оси X.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set XAxis Title Text Style(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() .

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set YAxis Log Scale()

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

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set YAxis Range(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 Значение самой высокой линии сетки вертикальной оси.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set YAxis Text Style(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() .

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set YAxis Title(title)

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

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

Параметры

Имя Тип Описание
title String Название оси Y.

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.


set YAxis Title Text Style(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() .

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

Scatter Chart Builder — этот построитель полезен для создания цепочек.