Обзор
Пузырьковая диаграмма, отображаемая в браузере с использованием SVG или VML . Отображает подсказки при наведении курсора на пузырьки.
Пузырьковая диаграмма используется для визуализации набора данных с двумя-четырьмя измерениями. Первые два измерения визуализируются как координаты, третье — как цвет, а четвертое — как размер.
Пример
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawSeriesChart); function drawSeriesChart() { var data = google.visualization.arrayToDataTable([ ['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'], ['CAN', 80.66, 1.67, 'North America', 33739900], ['DEU', 79.84, 1.36, 'Europe', 81902307], ['DNK', 78.6, 1.84, 'Europe', 5523095], ['EGY', 72.73, 2.78, 'Middle East', 79716203], ['GBR', 80.05, 2, 'Europe', 61801570], ['IRN', 72.49, 1.7, 'Middle East', 73137148], ['IRQ', 68.09, 4.77, 'Middle East', 31090763], ['ISR', 81.55, 2.96, 'Middle East', 7485600], ['RUS', 68.6, 1.54, 'Europe', 141850000], ['USA', 78.09, 2.05, 'North America', 307007000] ]); var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: {textStyle: {fontSize: 11}} }; var chart = new google.visualization.BubbleChart(document.getElementById('series_chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="series_chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Цвет по номерам
Вы можете использовать опцию colorAxis
, чтобы раскрасить пузырьки пропорционально значению, как показано в примере ниже.
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:["corechart"]}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['ID', 'X', 'Y', 'Temperature'], ['', 80, 167, 120], ['', 79, 136, 130], ['', 78, 184, 50], ['', 72, 278, 230], ['', 81, 200, 210], ['', 72, 170, 100], ['', 68, 477, 80] ]); var options = { colorAxis: {colors: ['yellow', 'red']} }; var chart = new google.visualization.BubbleChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Настройка этикеток
Вы можете управлять пузырьковым шрифтом, шрифтом и цветом с помощью параметра bubble.textStyle
:
var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { fontSize: 12, fontName: 'Times-Roman', color: 'green', bold: true, italic: true } } };
<head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:["corechart"]}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'], ['CAN', 80.66, 1.67, 'North America', 33739900], ['DEU', 79.84, 1.36, 'Europe', 81902307], ['DNK', 78.6, 1.84, 'Europe', 5523095], ['EGY', 72.73, 2.78, 'Middle East', 79716203], ['GBR', 80.05, 2, 'Europe', 61801570], ['IRN', 72.49, 1.7, 'Middle East', 73137148], ['IRQ', 68.09, 4.77, 'Middle East', 31090763], ['ISR', 81.55, 2.96, 'Middle East', 7485600], ['RUS', 68.6, 1.54, 'Europe', 141850000], ['USA', 78.09, 2.05, 'North America', 307007000] ]); var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { fontSize: 12, fontName: 'Times-Roman', color: 'green', bold: true, italic: true } } }; var chart = new google.visualization.BubbleChart(document.getElementById('textstyle')); chart.draw(data, options); } </script> </head> <body> <div id="textstyle" style="width: 900px; height: 500px;"></div> </body> </html>
Метки на приведенной выше диаграмме трудно читать, и одна из причин — пустое пространство вокруг них. Это называется аурой , и если вы предпочитаете, чтобы ваши диаграммы были без них, вы можете установить для bubble.textStyle.auraColor
значение 'none'
.
var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { auraColor: 'none' } } };
<head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:["corechart"]}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'], ['CAN', 80.66, 1.67, 'North America', 33739900], ['DEU', 79.84, 1.36, 'Europe', 81902307], ['DNK', 78.6, 1.84, 'Europe', 5523095], ['EGY', 72.73, 2.78, 'Middle East', 79716203], ['GBR', 80.05, 2, 'Europe', 61801570], ['IRN', 72.49, 1.7, 'Middle East', 73137148], ['IRQ', 68.09, 4.77, 'Middle East', 31090763], ['ISR', 81.55, 2.96, 'Middle East', 7485600], ['RUS', 68.6, 1.54, 'Europe', 141850000], ['USA', 78.09, 2.05, 'North America', 307007000] ]); var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { auraColor: 'none', } } }; var chart = new google.visualization.BubbleChart(document.getElementById('noAura')); chart.draw(data, options); } </script> </head> <body> <div id="noAura" style="width: 900px; height: 500px;"></div> </body> </html>
Загрузка
Имя пакета google.charts.load
— "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
Имя класса визуализации — google.visualization.BubbleChart
.
var visualization = new google.visualization.BubbleChart(container);
Формат данных
Строки: каждая строка в таблице представляет один пузырь.
Столбцы:
Столбец 0 | Столбец 1 | Столбец 2 | Столбец 3 (необязательно) | Столбец 4 (необязательно) | |
---|---|---|---|---|---|
Цель: | ID (название) пузырька | координата X | координата Y | Либо идентификатор серии, либо значение, представляющее цвет по градиентной шкале, в зависимости от типа столбца:
| Размер; значения в этом столбце сопоставляются с фактическими значениями пикселей с помощью параметра sizeAxis . |
Тип данных: | нить | число | число | строка или число | число |
Параметры конфигурации
Имя | |
---|---|
анимация.длительность | Продолжительность анимации в миллисекундах. Подробности смотрите в документации по анимации . Тип: номер По умолчанию: 0 |
анимация.easing | Функция замедления, примененная к анимации. Доступны следующие варианты:
Тип: строка По умолчанию: «линейный» |
анимация.стартап | Определяет, будет ли диаграмма анимироваться при первоначальном рисовании. Если Тип: логический По умолчанию ложь |
осьНазванияПозиция | Где разместить заголовки осей по сравнению с областью диаграммы. Поддерживаемые значения:
Тип: строка По умолчанию: «выход» |
фоновый цвет | Цвет фона основной области диаграммы. Это может быть либо простая цветовая строка HTML, например: Тип: строка или объект По умолчанию: «белый» |
фонЦвет.обводка | Цвет границы диаграммы в виде цветовой строки HTML. Тип: строка По умолчанию: '#666' |
backgroundColor.strokeWidth | Ширина границы в пикселях. Тип: номер По умолчанию: 0 |
фонЦвет.заливка | Цвет заливки диаграммы в виде цветовой строки HTML. Тип: строка По умолчанию: «белый» |
пузырь | Объект с членами для настройки визуальных свойств пузырьков. Тип: объект По умолчанию: ноль |
пузырь.непрозрачность | Непрозрачность пузырьков, где 0 — полностью прозрачный, а 1 — полностью непрозрачный. Тип: число от 0,0 до 1,0. По умолчанию: 0,8 |
пузырь.удар | Цвет обводки пузырьков. Тип: строка По умолчанию: '#ccc' |
bubble.textStyle | Объект, определяющий стиль пузырькового текста. Объект имеет такой формат: {color: <string>, fontName: <string>, fontSize: <number>} Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
область диаграммы | Объект с элементами для настройки размещения и размера области диаграммы (где рисуется сама диаграмма, исключая оси и легенды). Поддерживаются два формата: число или число, за которым следует %. Простое число — это значение в пикселях; число, за которым следует %, представляет собой процент. Пример: Тип: объект По умолчанию: ноль |
chartArea.backgroundColor | Цвет фона области диаграммы. Когда используется строка, это может быть либо шестнадцатеричная строка (например, «#fdc»), либо название цвета на английском языке. При использовании объекта могут быть предоставлены следующие свойства:
Тип: строка или объект По умолчанию: «белый» |
диаграммаArea.left | Насколько далеко рисовать диаграмму от левой границы. Тип: число или строка. По умолчанию: авто |
диаграммаArea.top | На каком расстоянии рисовать диаграмму от верхней границы. Тип: число или строка. По умолчанию: авто |
ChartArea.width | Ширина области диаграммы. Тип: число или строка. По умолчанию: авто |
диаграммаArea.height | Высота области диаграммы. Тип: число или строка. По умолчанию: авто |
цвета | Цвета, используемые для элементов диаграммы. Массив строк, где каждый элемент представляет собой строку цвета HTML, например: Тип: Массив строк. По умолчанию: цвета по умолчанию |
цветОсь | Объект, определяющий сопоставление между значениями столбца цвета и цветами или шкалой градиента. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {minValue: 0, colors: ['#FF0000', '#00FF00']} Тип: объект По умолчанию: ноль |
colorAxis.minValue | Если присутствует, указывает минимальное значение для данных цвета диаграммы. Значения цветовых данных этого значения и ниже будут отображаться как первый цвет в диапазоне Тип: номер По умолчанию: минимальное значение столбца цвета в данных диаграммы. |
цветAxis.maxValue | Если присутствует, указывает максимальное значение для данных цвета диаграммы. Значения цветовых данных этого значения и выше будут отображаться как последний цвет в диапазоне Тип: номер По умолчанию: максимальное значение столбца цвета в данных диаграммы. |
colorAxis.values | Если присутствует, управляет тем, как значения связаны с цветами. Каждое значение связано с соответствующим цветом в массиве Тип: массив чисел По умолчанию: ноль |
colorAxis.colors | Цвета для назначения значениям в визуализации. Массив строк, где каждый элемент представляет собой строку цвета HTML, например: Тип: массив цветных строк. По умолчанию: ноль |
colorAxis.legend | Объект, определяющий стиль легенды цвета градиента. Тип: объект По умолчанию: ноль |
colorAxis.legend.position | Позиция легенды. Может быть одним из следующих:
Тип: объект По умолчанию: «сверху» |
colorAxis.legend.textStyle | Объект, определяющий стиль текста легенды. Объект имеет такой формат: {color: <string>, fontName: <string>, fontSize: <number>} Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
colorAxis.legend.numberFormat | Строка формата для числовых меток. Это подмножество набора шаблонов ICU . Например, Тип: строка По умолчанию: авто |
включитьИнтерактивность | Определяет ли диаграмма события, связанные с пользователем, или реагирует на взаимодействие с пользователем. Если установлено значение false, диаграмма не будет генерировать события «выбор» или другие события, основанные на взаимодействии (но будет генерировать события готовности или ошибки), а также не будет отображать наводящий текст или иным образом изменяться в зависимости от ввода пользователя. Тип: логический По умолчанию: правда |
исследователь | Опция Эта функция является экспериментальной и может измениться в будущих выпусках. Примечание. Проводник работает только с непрерывными осями (например, числами или датами). Тип: объект По умолчанию: ноль |
explorer.actions | Обозреватель Google Charts поддерживает три действия:
Тип: Массив строк. По умолчанию: ['dragToPan', 'rightClickToReset'] |
explorer.axis | По умолчанию пользователи могут панорамировать как по горизонтали, так и по вертикали, когда используется опция Тип: строка По умолчанию: горизонтальное и вертикальное панорамирование. |
explorer.keepInBounds | По умолчанию пользователи могут панорамировать все вокруг, независимо от того, где находятся данные. Чтобы гарантировать, что пользователи не выходят за пределы исходной диаграммы, используйте Тип: логический По умолчанию: ложь |
explorer.maxZoomIn | Максимальное увеличение, которое может увеличить проводник. По умолчанию пользователи смогут увеличить масштаб настолько, что смогут видеть только 25 % исходного изображения. Настройка Тип: номер По умолчанию: 0,25 |
explorer.maxZoomOut | Максимум, на который может уменьшить масштаб проводник. По умолчанию пользователи смогут уменьшить масштаб настолько, что диаграмма будет занимать только 1/4 доступного пространства. Настройка Тип: номер По умолчанию: 4 |
explorer.zoomDelta | Когда пользователи увеличивают или уменьшают масштаб, Тип: номер По умолчанию: 1,5 |
размер шрифта | Размер шрифта по умолчанию (в пикселях) для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы. Тип: номер По умолчанию: автоматический |
имя шрифта | Шрифт по умолчанию для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы. Тип: строка По умолчанию: «Ариал» |
сила IFrame | Рисует диаграмму внутри встроенного фрейма. (Обратите внимание, что в IE8 этот параметр игнорируется; все диаграммы IE8 рисуются в i-кадрах.) Тип: логический По умолчанию: ложь |
ось | Объект с элементами для настройки различных элементов горизонтальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Тип: объект По умолчанию: ноль |
hAxis.baseline | Базовая линия для горизонтальной оси. Тип: номер По умолчанию: автоматический |
hAxis.baselineColor | Цвет базовой линии горизонтальной оси. Может быть любой цветовой строкой HTML, например: Тип: номер По умолчанию: «черный» |
hAxis.direction | Направление роста значений по горизонтальной оси. Укажите Тип: 1 или -1 По умолчанию: 1 |
hAxis.format | Строка формата для меток числовых осей. Это подмножество набора шаблонов ICU . Например,
Фактическое форматирование, примененное к метке, определяется языковым стандартом, с которым был загружен API. Дополнительные сведения см. в разделе Загрузка диаграмм с определенной локалью . При вычислении значений делений и линий сетки будут рассматриваться несколько альтернативных комбинаций всех соответствующих вариантов линий сетки, и альтернативы будут отклонены, если отформатированные метки делений будут дублироваться или перекрываться. Таким образом, вы можете указать Тип: строка По умолчанию: авто |
hAxis.gridlines | Объект со свойствами для настройки линий сетки на горизонтальной оси. Обратите внимание, что линии сетки по горизонтальной оси рисуются вертикально. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {color: '#333', minSpacing: 20} Тип: объект По умолчанию: ноль |
hAxis.gridlines.color | Цвет горизонтальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML. Тип: строка По умолчанию: '#CCC' |
hAxis.gridlines.count | Примерное количество горизонтальных линий сетки внутри области диаграммы. Если вы укажете положительное число для Тип: номер По умолчанию: -1 |
hAxis.gridlines.units | Переопределяет формат по умолчанию для различных аспектов типов данных date/datetime/timeofday при использовании с вычисляемыми линиями сетки диаграммы. Позволяет форматировать годы, месяцы, дни, часы, минуты, секунды и миллисекунды. Общий формат: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Дополнительную информацию можно найти в разделе Даты и время . Тип: объект По умолчанию: ноль |
hAxis.minorGridlines | Объект с элементами для настройки второстепенных линий сетки на горизонтальной оси, аналогично параметру hAxis.gridlines. Тип: объект По умолчанию: ноль |
hAxis.minorGridlines.color | Цвет второстепенных горизонтальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML. Тип: строка По умолчанию: сочетание цветов линии сетки и фона. |
hAxis.minorGridlines.count | Параметр Тип: номер По умолчанию: 1 |
hAxis.minorGridlines.units | Переопределяет формат по умолчанию для различных аспектов типов данных date/datetime/timeofday при использовании с вычисляемыми диаграммами majorGridlines. Позволяет форматировать годы, месяцы, дни, часы, минуты, секунды и миллисекунды. Общий формат: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Дополнительную информацию можно найти в разделе Даты и время . Тип: объект По умолчанию: ноль |
hAxis.logScale | Свойство Тип: логический По умолчанию: ложь |
hAxis.scaleType | Свойство
Тип: строка По умолчанию: ноль |
hAxis.textPosition | Положение текста по горизонтальной оси относительно области диаграммы. Поддерживаемые значения: «вне», «вход», «нет». Тип: строка По умолчанию: «выход» |
hAxis.textStyle | Объект, определяющий стиль текста по горизонтальной оси. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
hAxis.ticks | Заменяет автоматически сгенерированные отметки оси X указанным массивом. Каждый элемент массива должен быть либо допустимым значением тика (например, числом, датой, датой и временем или днем), либо объектом. Если это объект, он должен иметь свойство ViewWindow будет автоматически расширен, чтобы включить отметки min и max, если вы не укажете Примеры:
Тип: Массив элементов По умолчанию: авто |
hAxis.title | Свойство Тип: строка По умолчанию: ноль |
hAxis.titleTextStyle | Объект, определяющий стиль текста заголовка по горизонтальной оси. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
hAxis.maxValue | Перемещает максимальное значение горизонтальной оси на указанное значение; на большинстве графиков это будет вправо. Игнорируется, если для этого параметра установлено значение меньше максимального значения x данных. Тип: номер По умолчанию: автоматический |
hAxis.minValue | Перемещает минимальное значение горизонтальной оси на указанное значение; на большинстве графиков это будет левое положение. Игнорируется, если для этого параметра установлено значение, превышающее минимальное значение x данных. Тип: номер По умолчанию: автоматический |
hAxis.viewWindowMode | Указывает, как масштабировать горизонтальную ось для отображения значений в области диаграммы. Поддерживаются следующие строковые значения:
Тип: строка По умолчанию: эквивалент «pretty», но haxis.viewWindow.min и haxis.viewWindow.max имеют приоритет, если они используются. |
hAxis.viewWindow | Указывает диапазон обрезки горизонтальной оси. Тип: объект По умолчанию: ноль |
hAxis.viewWindow.max | Максимальное значение горизонтальных данных для визуализации. Игнорируется, когда Тип: номер По умолчанию: авто |
hAxis.viewWindow.min | Минимальное значение горизонтальных данных для визуализации. Игнорируется, когда Тип: номер По умолчанию: авто |
высота | Высота диаграммы в пикселях. Тип: номер По умолчанию: высота содержащего элемента. |
легенда | Объект с членами для настройки различных аспектов легенды. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Тип: объект По умолчанию: ноль |
легенда.выравнивание | Согласование легенды. Может быть одним из следующих:
Начало, центр и конец зависят от стиля легенды (вертикального или горизонтального). Например, в «правой» легенде «начало» и «конец» находятся вверху и внизу соответственно; для «верхней» легенды «начало» и «конец» будут находиться слева и справа от области соответственно. Значение по умолчанию зависит от положения легенды. Для «нижних» легенд по умолчанию используется «центр»; другие легенды по умолчанию имеют значение «старт». Тип: строка По умолчанию: автоматический |
легенда.maxLines | Максимальное количество строк в легенде. Установите для этого числа значение больше единицы, чтобы добавить строки в легенду. Примечание. Точная логика, используемая для определения фактического количества отображаемых строк, все еще находится в стадии разработки. В настоящее время эта опция работает только тогда, когда Legend.position имеет значение «top». Тип: номер По умолчанию: 1 |
легенда.pageIndex | Начальный выбранный индекс страницы легенды, отсчитываемый от нуля. Тип: номер По умолчанию: 0 |
легенда.позиция | Позиция легенды. Может быть одним из следующих:
Тип: строка По умолчанию: «право» |
Legend.textStyle | Объект, определяющий стиль текста легенды. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
режим выбора | Если Тип: строка По умолчанию: «одиночный» |
ряд | Объект объектов, ключами которого являются названия серий (значения в столбце Цвет) и каждый объект, описывающий формат соответствующей серии на диаграмме. Если серия или значение не указаны, будет использоваться глобальное значение. Каждый объект поддерживает следующие свойства:
series: {'Europe': {color: 'green'}} Тип: Объект с вложенными объектами. По умолчанию: {} |
размерОсь | Объект с элементами для настройки связи значений с размером пузырька. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {minValue: 0, maxSize: 20} Тип: объект По умолчанию: ноль |
sizeAxis.maxSize | Максимальный радиус максимально возможного пузырька в пикселях. Тип: номер По умолчанию: 30 |
sizeAxis.maxValue | Значение размера (как показано в данных диаграммы), которое должно быть сопоставлено с Тип: номер По умолчанию: максимальное значение столбца размера в данных диаграммы. |
sizeAxis.minSize | Минимальный радиус наименьшего возможного пузырька в пикселях. Тип: номер По умолчанию: 5 |
sizeAxis.minValue | Значение размера (как показано в данных диаграммы), которое должно быть сопоставлено с Тип: номер По умолчанию: минимальное значение столбца размера в данных диаграммы. |
сортировкаПузыриПоРазмеру | Если это правда, пузырьки сортируются по размеру, чтобы пузырьки меньшего размера располагались над пузырьками большего размера. Если установлено значение false, пузырьки сортируются в соответствии с их порядком в DataTable. Тип: логический По умолчанию: правда |
тема | Тема — это набор предопределенных значений параметров, которые вместе обеспечивают достижение определенного поведения диаграммы или визуального эффекта. На данный момент доступна только одна тема:
Тип: строка По умолчанию: ноль |
заголовок | Текст для отображения над диаграммой. Тип: строка По умолчанию: без названия |
НазваниеПозиция | Где разместить заголовок диаграммы по сравнению с областью диаграммы. Поддерживаемые значения:
Тип: строка По умолчанию: «выход» |
заголовокTextStyle | Объект, определяющий стиль текста заголовка. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
подсказка | Объект с членами для настройки различных элементов подсказки. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {textStyle: {color: '#FF0000'}, showColorCode: true} Тип: объект По умолчанию: ноль |
подсказка.isHtml | Если установлено значение true, используйте всплывающие подсказки, отображаемые в формате HTML (а не в формате SVG). Дополнительные сведения см. в разделе «Настройка содержимого всплывающей подсказки» . Примечание. Настройка содержимого всплывающей подсказки HTML с помощью роли данных столбца подсказки не поддерживается визуализацией пузырьковой диаграммы . Тип: логический По умолчанию: ложь |
Tooltip.textStyle | Объект, определяющий стиль текста подсказки. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
подсказка.триггер | Взаимодействие пользователя, вызывающее отображение всплывающей подсказки:
Тип: строка По умолчанию: «фокус» |
вАксис | Объект с элементами для настройки различных элементов вертикальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Тип: объект По умолчанию: ноль |
vAxis.baseline | Свойство Тип: номер По умолчанию: автоматический |
vAxis.baselineColor | Указывает цвет базовой линии вертикальной оси. Может быть любой цветовой строкой HTML, например: Тип: номер По умолчанию: «черный» |
vAxis.direction | Направление роста значений по вертикальной оси. По умолчанию низкие значения находятся внизу диаграммы. Укажите Тип: 1 или -1 По умолчанию: 1 |
vAxis.format | Строка формата для меток числовых осей. Это подмножество набора шаблонов ICU . Например,
Фактическое форматирование, примененное к метке, определяется языковым стандартом, с которым был загружен API. Дополнительные сведения см. в разделе Загрузка диаграмм с определенной локалью . При вычислении значений делений и линий сетки будут рассматриваться несколько альтернативных комбинаций всех соответствующих вариантов линий сетки, и альтернативы будут отклонены, если отформатированные метки делений будут дублироваться или перекрываться. Таким образом, вы можете указать Тип: строка По умолчанию: авто |
vAxis.gridlines | Объект с элементами для настройки линий сетки по вертикальной оси. Обратите внимание, что линии сетки по вертикальной оси рисуются горизонтально. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {color: '#333', minSpacing: 20} Тип: объект По умолчанию: ноль |
vAxis.gridlines.color | Цвет вертикальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML. Тип: строка По умолчанию: '#CCC' |
vAxis.gridlines.count | Примерное количество горизонтальных линий сетки внутри области диаграммы. Если вы укажете положительное число для Тип: номер По умолчанию: -1 |
vAxis.gridlines.units | Переопределяет формат по умолчанию для различных аспектов типов данных date/datetime/timeofday при использовании с вычисляемыми линиями сетки диаграммы. Позволяет форматировать годы, месяцы, дни, часы, минуты, секунды и миллисекунды. Общий формат: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]}, hours: {format: [/*format strings here*/]}, minutes: {format: [/*format strings here*/]}, seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]} } } Дополнительную информацию можно найти в разделе Даты и время . Тип: объект По умолчанию: ноль |
vAxis.minorGridlines | Объект с элементами для настройки второстепенных линий сетки на вертикальной оси, аналогично параметру vAxis.gridlines. Тип: объект По умолчанию: ноль |
vAxis.minorGridlines.color | Цвет второстепенных вертикальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML. Тип: строка По умолчанию: сочетание цветов линии сетки и фона. |
vAxis.minorGridlines.count | Параметр majorGridlines.count по большей части устарел, за исключением отключения второстепенных линий сетки путем установки счетчика равным 0. Количество второстепенных линий сетки зависит от интервала между основными линиями сетки (см. vAxis.gridlines.interval) и минимально необходимого пространства (см. vAxis. minorGridlines.minSpacing). Тип: номер По умолчанию: 1 |
vAxis.minorGridlines.units | Переопределяет формат по умолчанию для различных аспектов типов данных date/datetime/timeofday при использовании с вычисляемыми диаграммами majorGridlines. Позволяет форматировать годы, месяцы, дни, часы, минуты, секунды и миллисекунды. Общий формат: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Дополнительную информацию можно найти в разделе Даты и время . Тип: объект По умолчанию: ноль |
vAxis.logScale | Если это правда, вертикальная ось принимает логарифмический масштаб. Примечание. Все значения должны быть положительными. Тип: логический По умолчанию: ложь |
vAxis.scaleType | Свойство
Тип: строка По умолчанию: ноль |
vAxis.textPosition | Положение текста вертикальной оси относительно области диаграммы. Поддерживаемые значения: «вне», «вход», «нет». Тип: строка По умолчанию: «выход» |
vAxis.textStyle | Объект, задающий стиль текста по вертикальной оси. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
vAxis.ticks | Заменяет автоматически сгенерированные отметки оси Y указанным массивом. Каждый элемент массива должен быть либо допустимым значением тика (например, числом, датой, датой и временем или днем), либо объектом. Если это объект, он должен иметь свойство ViewWindow будет автоматически расширен, чтобы включить отметки min и max, если вы не укажете Примеры:
Тип: Массив элементов По умолчанию: авто |
vAxis.title | Свойство Тип: строка По умолчанию: без названия |
vAxis.titleTextStyle | Объект, определяющий стиль текста заголовка вертикальной оси. Объект имеет такой формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
vAxis.maxValue | Перемещает максимальное значение вертикальной оси на указанное значение; на большинстве графиков это будет вверх. Игнорируется, если для этого параметра установлено значение меньше максимального значения y данных. Тип: номер По умолчанию: автоматический |
vAxis.minValue | Перемещает минимальное значение вертикальной оси на указанное значение; на большинстве графиков это будет снижение. Игнорируется, если это установлено значение, превышающему минимальное значение y данных. Тип: номер По умолчанию: NULL |
vaxis.viewwindowmode | Указывает, как масштабировать вертикальную ось, чтобы отобразить значения в области диаграммы. Поддерживаются следующие строковые значения:
Тип: строка По умолчанию: эквивалент «красиво», но vaxis.viewWindow.min и vaxis.viewWindow.max имеет приоритет при использовании. |
vaxis.viewwindow | Указывает диапазон обрезки вертикальной оси. Тип: объект По умолчанию: NULL |
vaxis.viewwindow.max | Максимальное значение вертикального данных для рендеринга. Игнорируется, когда Тип: номер По умолчанию: Auto |
vaxis.viewwindow.min | Минимальное значение вертикального данных для рендеринга. Игнорируется, когда Тип: номер По умолчанию: Auto |
ширина | Ширина диаграммы, в пикселях. Тип: номер По умолчанию: ширина содержащего элемента |
Методы
Метод | |
---|---|
draw(data, options) | Рисует диаграмму. Диаграмма принимает дальнейшие вызовы метода только после того, как Возвращение типа: нет |
getAction(actionID) | Возвращает объект действий подсказки инструментов с запрошенным Возвращение типа: объект |
getBoundingBox(id) | Возвращает объект, содержащий левую, верхнюю, ширину и высоту
Значения относительно контейнера диаграммы. Назовите это после того, как график будет нарисована. Возвращение типа: объект |
getChartAreaBoundingBox() | Возвращает объект, содержащий левую, верхнюю, ширину и высоту содержания диаграммы (то есть, исключая этикетки и легенду):
Значения относительно контейнера диаграммы. Назовите это после того, как график будет нарисована. Возвращение типа: объект |
getChartLayoutInterface() | Возвращает объект, содержащий информацию о экране размещения диаграммы и его элементов. Следующие методы можно вызвать на возвращаемый объект:
Назовите это после того, как график будет нарисована. Возвращение типа: объект |
getHAxisValue(xPosition, optional_axis_index) | Возвращает горизонтальное значение данных при Пример: Назовите это после того, как график будет нарисована. Возврат тип: номер |
getImageURI() | Возвращает диаграмму, сериализованную как изображение URI. Назовите это после того, как график будет нарисована. Смотрите печатные диаграммы PNG . Возвращение типа: строка |
getSelection() | Возвращает массив выбранных диаграмм. Выбираемые объекты - пузырьки. Для этой диаграммы можно выбрать только один объект в любой момент. Тип возврата: массив элементов выбора |
getVAxisValue(yPosition, optional_axis_index) | Возвращает вертикальное значение данных при Пример: Назовите это после того, как график будет нарисована. Возврат тип: номер |
getXLocation(dataValue, optional_axis_index) | Возвращает Pixel X-координату Пример: Назовите это после того, как график будет нарисована. Возврат тип: номер |
getYLocation(dataValue, optional_axis_index) | Возвращает Pixel Y-координату Пример: Назовите это после того, как график будет нарисована. Возврат тип: номер |
removeAction(actionID) | Удаляет действие подсказки инструментов с помощью запрошенного Возвращение типа: none |
setAction(action) | Устанавливает действие подсказки инструментов для выполнения, когда пользователь нажимает на текст действия. Метод Любые действия по всплеске инструментов должны быть установлены до вызова метода Возвращение типа: none |
setSelection() | Выбирает указанные диаграммы. Отменяет любой предыдущий выбор. Выбираемые объекты - пузырьки. Для этой диаграммы можно выбрать только один объект. Возвращение типа: нет |
clearChart() | Очищает диаграмму и выпускает все его выделенные ресурсы. Возвращение типа: нет |
События
Для получения дополнительной информации о том, как использовать эти события, см. Базовую интерактивность , обработку событий и стрельбы .
Имя | |
---|---|
animationfinish | Уволен, когда переходная анимация завершена. Свойства: нет |
click | Запускается, когда пользователь щелкнет внутри диаграммы. Можно использовать для определения того, когда нажимают заголовок, элементы данных, записи легенды, оси, сетки или метки. Свойства: TargetId |
error | Уволен, когда возникает ошибка при попытке отобрать диаграмму. Свойства: ID, сообщение |
legendpagination | Запускается, когда пользователь нажимает стрелки Legend Pagination. Обращает обратно текущий индекс страниц на основе Legend Zero и общее количество страниц. Свойства: CurrentPageIndex, TotalPages |
onmouseover | Уволен, когда пользователь объединяет визуальную сущность. Передает индексы строки и столбца соответствующего элемента таблицы данных. Пузырь коррелирует со строкой в таблице данных (индекс столбца нулевой). Свойства: ряд, столбец |
onmouseout | Выстрелил, когда пользователь уходит от визуальной сущности. Передает индексы строки и столбца соответствующего элемента таблицы данных. Пузырь коррелирует со строкой в таблице данных (индекс столбца нулевой). Свойства: ряд, столбец |
ready | Диаграмма готова к внешним вызовам метода. Если вы хотите взаимодействовать с диаграммой и вызовать методы после того, как вы нарисуете его, вам следует настроить слушателя для этого события , прежде чем позвонить в метод Свойства: нет |
select | Уволен, когда пользователь нажимает на визуальную сущность. Чтобы узнать, что было выбрано, позвоните Свойства: нет |
Политика данных
Все код и данные обрабатываются и отображаются в браузере. Никакие данные не отправляются ни на один сервер.