Конструктор круговых диаграмм. Для получения более подробной информации см. документацию 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 — этот конструктор полезен для построения цепочек диаграмм.