Class PieChartBuilder

PieChartBuilder

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

Вот пример, демонстрирующий построение круговой диаграммы. Данные импортированы из электронной таблицы Google .

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

const chartBuilder = Charts.newPieChart()
                         .setTitle('World Population by Continent')
                         .setDimensions(600, 500)
                         .set3D()
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Методы

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

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

build()

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

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

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


reverseCategories()

Изменяет порядок отображения рядов данных по оси координат. Для диаграмм с вертикальным диапазоном (таких как линейные, площадные или столбчатые диаграммы) это означает, что горизонтальная ось отображается справа налево. Для диаграмм с горизонтальным диапазоном (таких как гистограммы) это означает, что вертикальная ось отображается сверху вниз. Для круговых диаграмм это означает, что сектора отображаются против часовой стрелки.

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

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

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


set3D()

Задает трехмерный формат графика.

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

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


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" ).

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

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


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-й линии на графике.

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

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


setDataSourceUrl(url)

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

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

Параметры

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

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

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


setDataTable(tableBuilder)

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

Параметры

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

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

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


setDataTable(table)

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

Параметры

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

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

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


setDataViewDefinition(dataViewDefinition)

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

Параметры

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

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

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


setDimensions(width, height)

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

Параметры

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

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

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


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 Положение легенды.

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

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


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

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

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


setOption(option, value)

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

// Build a pie chart with a pretty legend.
const builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
const chart = builder.build();

Параметры

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

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

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


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 заголовок диаграммы.

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

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


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() .

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

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