Обзор
Ступенчатая диаграмма с областями, отображаемая в браузере с использованием 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(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Director (Year)', 'Rotten Tomatoes', 'IMDB'], ['Alfred Hitchcock (1935)', 8.4, 7.9], ['Ralph Thomas (1959)', 6.9, 6.5], ['Don Sharp (1978)', 6.5, 6.4], ['James Hawes (2008)', 4.4, 6.2] ]); var options = { title: 'The decline of \'The 39 Steps\'', vAxis: {title: 'Accumulated Rating'}, isStacked: true }; var chart = new google.visualization.SteppedAreaChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Некоторые распространенные варианты
Как и все диаграммы Google, ступенчатые диаграммы с областями имеют множество параметров, показанных здесь . Вот пример, демонстрирующий некоторые из наиболее распространенных:
На приведенной выше диаграмме мы изменили цвет фона с помощью backgroundColor
, переместили легенду вниз с помощью legend.position
, удалили вертикальные линии, установив для параметра connectSteps
значение false, и настроили цвета. Вот как это было сделано:
var options = { backgroundColor: '#ddd', legend: { position: 'bottom' }, connectSteps: false, colors: ['#4374E0', '#53A8FB', '#F1CA3A', '#E49307'], isStacked: true, };
Диаграммы с ступенчатыми областями с накоплением
Ступенчатые диаграммы с областями также поддерживают суммирование, в том числе 100 %. Составная ступенчатая диаграмма с областями — это ступенчатая диаграмма с областями, на которой связанные значения располагаются друг над другом. Если есть отрицательные значения, они располагаются в обратном порядке ниже базовой линии диаграммы. Для 100%-ного стекирования стеки элементов в каждом значении домена масштабируются таким образом, что их сумма составляет 100%. Для этого доступны следующие параметры isStacked: 'percent'
, который форматирует каждое значение как процент от 100 %, и isStacked: 'relative'
, который форматирует каждое значение как дробь от 1. Существует также опция isStacked: 'absolute'
, что функционально эквивалентно isStacked: true
.
Обратите внимание, что на диаграмме с суммированием 100% справа значения тиков записаны на основе относительной шкалы 0–1 как доли от 1.
var options_stacked = { isStacked: true, height: 300, legend: {position: 'top', maxLines: 3}, vAxis: {minValue: 0} };
var options_fullStacked = { isStacked: 'relative', height: 300, legend: {position: 'top', maxLines: 3}, vAxis: { minValue: 0, ticks: [0, .3, .6, .9, 1] } };
Загрузка
Имя пакета google.charts.load
— "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
Имя класса визуализации — google.visualization.SteppedAreaChart
.
var visualization = new google.visualization.SteppedAreaChart(container);
Формат данных
Строки: каждая строка в таблице представляет группу столбцов.
Столбцы:
Столбец 0 | Столбец 1 | ... | Столбец N | |
---|---|---|---|---|
Цель: | Метки групп оси X | Значения бара 1 в этой группе | ... | Значения Bar N в этой группе |
Тип данных: | нить | число | ... | число |
Роль: | домен | данные | ... | данные |
Дополнительные роли столбцов : | ... |
Параметры конфигурации
Имя | |
---|---|
агрегацияTarget | Как несколько выбранных данных объединяются во всплывающие подсказки:
aggregationTarget часто будет использоваться в тандеме с selectionMode и tooltip.trigger , например:var options = { // Allow multiple // simultaneous selections. selectionMode: 'multiple', // Trigger tooltips // on selections. tooltip: {trigger: 'selection'}, // Group selections // by x-value. aggregationTarget: 'category', }; Тип: строка По умолчанию: «авто» |
анимация.длительность | Продолжительность анимации в миллисекундах. Подробности смотрите в документации по анимации . Тип: номер По умолчанию: 0 |
анимация.easing | Функция замедления, примененная к анимации. Доступны следующие варианты:
Тип: строка По умолчанию: «линейный» |
анимация.стартап | Определяет, будет ли диаграмма анимироваться при первоначальном рисовании. Если Тип: логический По умолчанию ложь |
площадьНепрозрачность | Непрозрачность области под ступенькой по умолчанию: 0,0 — полностью прозрачная, а 1,0 — полностью непрозрачная. Не влияет на непрозрачность ступенчатой линии. Чтобы получить ступенчатую линейную диаграмму, установите для этого значения значение 0. Чтобы указать непрозрачность для отдельной серии, установите значение Тип: число, 0,0–1,0 По умолчанию: 0,3 |
осьНазванияПозиция | Где разместить заголовки осей по сравнению с областью диаграммы. Поддерживаемые значения:
Тип: строка По умолчанию: «выход» |
фоновый цвет | Цвет фона основной области диаграммы. Это может быть либо простая цветовая строка HTML, например: Тип: строка или объект По умолчанию: «белый» |
фонЦвет.обводка | Цвет границы диаграммы в виде цветовой строки HTML. Тип: строка По умолчанию: '#666' |
backgroundColor.strokeWidth | Ширина границы в пикселях. Тип: номер По умолчанию: 0 |
фонЦвет.заливка | Цвет заливки диаграммы в виде цветовой строки HTML. Тип: строка По умолчанию: «белый» |
область диаграммы | Объект с элементами для настройки размещения и размера области диаграммы (где рисуется сама диаграмма, исключая оси и легенды). Поддерживаются два формата: число или число, за которым следует %. Простое число — это значение в пикселях; число, за которым следует %, представляет собой процент. Пример: Тип: объект По умолчанию: ноль |
chartArea.backgroundColor | Цвет фона области диаграммы. Когда используется строка, это может быть либо шестнадцатеричная строка (например, «#fdc»), либо название цвета на английском языке. При использовании объекта могут быть предоставлены следующие свойства:
Тип: строка или объект По умолчанию: «белый» |
диаграммаArea.left | Насколько далеко рисовать диаграмму от левой границы. Тип: число или строка. По умолчанию: авто |
диаграммаArea.top | На каком расстоянии рисовать диаграмму от верхней границы. Тип: число или строка. По умолчанию: авто |
ChartArea.width | Ширина области диаграммы. Тип: число или строка. По умолчанию: авто |
диаграммаArea.height | Высота области диаграммы. Тип: число или строка. По умолчанию: авто |
цвета | Цвета, используемые для элементов диаграммы. Массив строк, где каждый элемент представляет собой строку цвета HTML, например: Тип: Массив строк. По умолчанию: цвета по умолчанию |
ConnectSteps | Если установлено значение true, шаги соединятся в ступенчатую линию. В противном случае отображается только верхняя строка. По умолчанию шаги соединяются. Тип: логический По умолчанию: правда |
включитьИнтерактивность | Определяет ли диаграмма события, связанные с пользователем, или реагирует на взаимодействие с пользователем. Если значение равно false, диаграмма не будет генерировать события «выбор» или другие события, основанные на взаимодействии (но будет генерировать события готовности или ошибки), а также не будет отображать наводящий текст или иным образом изменяться в зависимости от ввода пользователя. Тип: логический По умолчанию: правда |
фокусЦель | Тип объекта, который получает фокус при наведении курсора мыши. Также влияет на то, какой объект выбирается щелчком мыши и какой элемент таблицы данных связан с событиями. Может быть одним из следующих:
В focusTarget «категория» всплывающая подсказка отображает все значения категории. Это может быть полезно для сравнения значений разных рядов. Тип: строка По умолчанию: «база данных» |
размер шрифта | Размер шрифта по умолчанию (в пикселях) для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы. Тип: номер По умолчанию: автоматический |
имя шрифта | Шрифт по умолчанию для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы. Тип: строка По умолчанию: «Ариал» |
сила IFrame | Рисует диаграмму внутри встроенного фрейма. (Обратите внимание, что в IE8 этот параметр игнорируется; все диаграммы IE8 рисуются в i-кадрах.) Тип: логический По умолчанию: ложь |
ось | Объект с элементами для настройки различных элементов горизонтальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Тип: объект По умолчанию: ноль |
hAxis.direction | Направление роста значений по горизонтальной оси. Укажите Тип: 1 или -1 По умолчанию: 1 |
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 будет автоматически расширен, чтобы включить минимальные и максимальные отметки, если вы не укажете Примеры:
Тип: Массив элементов По умолчанию: авто |
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.allowContainerBoundaryTextCutoff | Если установлено значение false, крайние метки будут скрыты, а не обрезаны контейнером диаграммы. Если true, будет разрешена обрезка меток. Тип: логический По умолчанию: ложь |
hAxis.slantedText | Если задано значение true, рисуйте текст по горизонтальной оси под углом, чтобы разместить больше текста вдоль оси; если false, рисует текст по горизонтальной оси вертикально. Поведение по умолчанию — наклонить текст, если он не может полностью поместиться в вертикальном положении. Обратите внимание, что этот параметр доступен только в том случае, если Тип: логический По умолчанию: автоматический |
hAxis.slantedTextAngle | Угол текста по горизонтальной оси, если он нарисован наклонно. Игнорируется, если Тип: число, -90—90 По умолчанию: 30 |
hAxis.maxАльтернация | Максимальное количество уровней текста по горизонтальной оси. Если текстовые метки осей становятся слишком перегруженными, сервер может сдвинуть соседние метки вверх или вниз, чтобы расположить метки ближе друг к другу. Это значение определяет наибольшее количество используемых уровней; сервер может использовать меньшее количество уровней, если метки могут помещаться без перекрытия. Для даты и времени значение по умолчанию — 1. Тип: номер По умолчанию: 2 |
hAxis.maxTextLines | Максимальное количество строк, разрешенное для текстовых меток. Метки могут занимать несколько строк, если они слишком длинные, а количество строк по умолчанию ограничено высотой доступного пространства. Тип: номер По умолчанию: авто |
hAxis.minTextSpacing | Минимальное горизонтальное расстояние в пикселях, допустимое между двумя соседними текстовыми метками. Если метки расположены слишком плотно или слишком длинные, интервал может упасть ниже этого порога, и в этом случае будет применена одна из мер по устранению беспорядка в метках (например, усечение меток или удаление некоторых из них). Тип: номер По умолчанию: значение hAxis.textStyle.fontSize |
hAxis.showTextEvery | Сколько меток по горизонтальной оси отображать, где 1 означает отображение каждой метки, 2 означает отображение каждой второй метки и т. д. По умолчанию мы пытаемся отобразить как можно больше меток без перекрытия. Тип: номер По умолчанию: автоматический |
hAxis.viewWindow | Указывает диапазон обрезки горизонтальной оси. Тип: объект По умолчанию: ноль |
hAxis.viewWindow.max | Индекс строки, отсчитываемый от нуля, где заканчивается окно обрезки. Точки данных с этим индексом и выше будут обрезаны. В сочетании с Игнорируется, когда Тип: номер По умолчанию: авто |
hAxis.viewWindow.min | Индекс строки, отсчитываемый от нуля, где начинается окно обрезки. Точки данных с индексами ниже этого будут обрезаны. В сочетании с Игнорируется, когда Тип: номер По умолчанию: авто |
высота | Высота диаграммы в пикселях. Тип: номер По умолчанию: высота содержащего элемента. |
isStacked | Если установлено значение true, элементы для всех рядов складываются в каждое значение домена. Примечание. В диаграммах «Столбец» , «Область» и «Ступенчатая область» Google Charts меняет порядок элементов легенды на обратный, чтобы лучше соответствовать расположению элементов серии (например, серия 0 будет самым нижним элементом легенды). Это не относится к гистограммам . Параметр Параметры
При 100% суммировании расчетное значение для каждого элемента появится во всплывающей подсказке после его фактического значения. Целевая ось по умолчанию будет отображать значения деления на основе относительной шкалы 0–1 в виде долей от 1 для 100-процентное стекирование поддерживает только значения данных типа Тип: логическое значение/строка По умолчанию: ложь |
легенда | Объект с членами для настройки различных аспектов легенды. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Тип: объект По умолчанию: ноль |
легенда.выравнивание | Согласование легенды. Может быть одним из следующих:
Начало, центр и конец зависят от стиля легенды (вертикального или горизонтального). Например, в «правой» легенде «начало» и «конец» находятся вверху и внизу соответственно; для «верхней» легенды «начало» и «конец» будут находиться слева и справа от области соответственно. Значение по умолчанию зависит от положения легенды. Для «нижних» легенд по умолчанию используется «центр»; другие легенды по умолчанию имеют значение «старт». Тип: строка По умолчанию: автоматический |
легенда.maxLines | Максимальное количество строк в легенде. Установите для этого числа значение больше единицы, чтобы добавить строки в легенду. Примечание. Точная логика, используемая для определения фактического количества отображаемых строк, все еще находится в стадии разработки. В настоящее время эта опция работает только тогда, когда Legend.position имеет значение «top». Тип: номер По умолчанию: 1 |
легенда.позиция | Позиция легенды. Может быть одним из следующих:
Тип: строка По умолчанию: «право» |
Legend.textStyle | Объект, определяющий стиль текста легенды. Объект имеет следующий формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
линияDashStyle | Схема включения и выключения пунктирных линий. Например, Тип: Массив чисел По умолчанию: ноль |
обратныеКатегории | Если установлено значение true, серия будет рисоваться справа налево. По умолчанию рисование осуществляется слева направо. Тип: логический По умолчанию: ложь |
режим выбора | Если Тип: строка По умолчанию: «одиночный» |
ряд | Массив объектов, каждый из которых описывает формат соответствующей серии на диаграмме. Чтобы использовать значения по умолчанию для серии, укажите пустой объект {}. Если серия или значение не указаны, будет использоваться глобальное значение. Каждый объект поддерживает следующие свойства:
Вы можете указать либо массив объектов, каждый из которых применяется к серии в указанном порядке, либо вы можете указать объект, в котором каждый дочерний элемент имеет числовой ключ, указывающий, к какой серии он применяется. Например, следующие два объявления идентичны и объявляют первую серию черной и отсутствующей в легенде, а четвертую — красной и отсутствующей в легенде: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } Тип: Массив объектов или объект со вложенными объектами. По умолчанию: {} |
тема | Тема — это набор предопределенных значений параметров, которые вместе обеспечивают достижение определенного поведения диаграммы или визуального эффекта. На данный момент доступна только одна тема:
Тип: строка По умолчанию: ноль |
заголовок | Текст для отображения над диаграммой. Тип: строка По умолчанию: без названия |
НазваниеПозиция | Где разместить заголовок диаграммы по сравнению с областью диаграммы. Поддерживаемые значения:
Тип: строка По умолчанию: «выход» |
заголовок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} Тип: объект По умолчанию: ноль |
Tooltip.ignoreBounds | Если установлено значение Примечание. Это относится только к всплывающим подсказкам HTML. Если это включено с помощью всплывающих подсказок SVG, любое переполнение за пределами границ диаграммы будет обрезано. Дополнительные сведения см. в разделе «Настройка содержимого всплывающей подсказки» . Тип: логический По умолчанию: ложь |
подсказка.isHtml | Если установлено значение true, используйте всплывающие подсказки, отображаемые в формате HTML (а не в формате SVG). Дополнительные сведения см. в разделе «Настройка содержимого всплывающей подсказки» . Примечание. Настройка содержимого всплывающей подсказки HTML с помощью роли данных столбца подсказки не поддерживается визуализацией пузырьковой диаграммы . Тип: логический По умолчанию: ложь |
Tooltip.showColorCode | Если это правда, отображайте цветные квадраты рядом с информацией о серии во всплывающей подсказке. Значение по умолчанию — true, если для Тип: логический По умолчанию: автоматический |
Tooltip.textStyle | Объект, определяющий стиль текста подсказки. Объект имеет следующий формат: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } Тип: объект По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
подсказка.триггер | Взаимодействие пользователя, вызывающее отображение всплывающей подсказки:
Тип: строка По умолчанию: «фокус» |
vAxes | Указывает свойства для отдельных вертикальных осей, если диаграмма имеет несколько вертикальных осей. Каждый дочерний объект является объектом Чтобы указать диаграмму с несколькими вертикальными осями, сначала определите новую ось с помощью { series: { 2: { targetAxisIndex:1 } }, vAxes: { 1: { title:'Losses', textStyle: {color: 'red'} } } } Это свойство может быть либо объектом, либо массивом: объект представляет собой набор объектов, каждый из которых имеет числовую метку, указывающую определяемую им ось — это формат, показанный выше; массив представляет собой массив объектов, по одному на ось. Например, следующая запись в стиле массива идентична объекту vAxes: [ {}, // Nothing specified for axis 0 { title:'Losses', textStyle: {color: 'red'} // Axis 1 } ] Тип: Массив объектов или объект с дочерними объектами. По умолчанию: ноль |
вАксис | Объект с элементами для настройки различных элементов вертикальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {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.minorGridlines | Объект с элементами для настройки второстепенных линий сетки на вертикальной оси, аналогично параметру vAxis.gridlines. Тип: объект По умолчанию: ноль |
vAxis.minorGridlines.color | Цвет второстепенных вертикальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML. Тип: строка По умолчанию: сочетание цветов линии сетки и фона. |
vAxis.minorGridlines.count | Опция majorGridlines.count по большей части устарела, за исключением отключения второстепенных линий сетки путем установки счетчика равным 0. Количество второстепенных линий сетки зависит от интервала между основными линиями сетки (см. vAxis.gridlines.interval) и минимально необходимого пространства (см. vAxis. minorGridlines.minSpacing). Тип: номер По умолчанию: 1 |
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 будет автоматически расширен, чтобы включить минимальные и максимальные отметки, если вы не укажете Примеры:
Тип: Массив элементов По умолчанию: авто |
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 данных. Тип: номер По умолчанию: ноль |
vAxis.viewWindowMode | Указывает, как масштабировать вертикальную ось для отображения значений в области диаграммы. Поддерживаются следующие строковые значения:
Тип: строка По умолчанию: эквивалентно «pretty», но vaxis.viewWindow.min и vaxis.viewWindow.max имеют приоритет, если они используются. |
vAxis.viewWindow | Указывает диапазон обрезки вертикальной оси. Тип: объект По умолчанию: ноль |
vAxis.viewWindow.max | Максимальное значение вертикальных данных для визуализации. Игнорируется, когда Тип: номер По умолчанию: авто |
vAxis.viewWindow.min | Минимальное значение вертикальных данных для визуализации. Игнорируется, когда Тип: номер По умолчанию: авто |
ширина | Ширина диаграммы в пикселях. Тип: номер По умолчанию: ширина содержащего элемента. |
Методы
Метод | |
---|---|
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) | Возвращает координату x в пикселях Пример: Вызовите это после того, как диаграмма будет нарисована. Тип возврата: число |
getYLocation(dataValue, optional_axis_index) | Возвращает координату y в пикселях Пример: Вызовите это после того, как диаграмма будет нарисована. Тип возврата: число |
removeAction(actionID) | Удаляет действие всплывающей подсказки с запрошенным Тип возврата: none |
setAction(action) | Устанавливает действие всплывающей подсказки, которое будет выполняться, когда пользователь нажимает на текст действия. Метод Любые действия подсказки должны быть установлены до вызова метода Тип возврата: none |
setSelection() | Выбирает указанные объекты диаграммы. Отменяет любой предыдущий выбор. Выбираемыми объектами являются шаги, записи легенды и категории. Шаг соответствует ячейке в таблице данных, запись легенды — столбцу (индекс строки равен нулю), а категория — строке (индекс столбца равен нулю). Для этой диаграммы одновременно можно выбрать только одну сущность. Тип возврата: нет |
clearChart() | Очищает диаграмму и освобождает все выделенные ей ресурсы. Тип возврата: нет |
События
Дополнительные сведения о том, как использовать эти события, см. в разделах «Базовое взаимодействие» , «Обработка событий» и «Инициирование событий» .
Имя | |
---|---|
animationfinish | Запускается, когда анимация перехода завершена. Свойства: нет |
click | Запускается, когда пользователь щелкает внутри диаграммы. Может использоваться для определения момента щелчка по заголовку, элементам данных, записям легенды, осям, линиям сетки или меткам. Свойства: targetID |
error | Вызывается, когда возникает ошибка при попытке отобразить диаграмму. Свойства: идентификатор, сообщение |
legendpagination | Вызывается, когда пользователь нажимает стрелки нумерации страниц легенды. Возвращает текущий индекс страницы легенды, отсчитываемый от нуля, и общее количество страниц. Свойства: currentPageIndex, totalPages. |
onmouseover | Вызывается, когда пользователь наводит указатель мыши на визуальный объект. Возвращает индексы строк и столбцов соответствующего элемента таблицы данных. Свойства: строка, столбец |
onmouseout | Вызывается, когда пользователь уводит указатель мыши от визуального объекта. Возвращает индексы строк и столбцов соответствующего элемента таблицы данных. Свойства: строка, столбец |
ready | Диаграмма готова для вызовов внешних методов. Если вы хотите взаимодействовать с диаграммой и вызывать методы после ее рисования, вам следует настроить прослушиватель этого события до вызова метода Свойства: нет |
select | Запускается, когда пользователь щелкает визуальный объект. Чтобы узнать, что было выбрано, вызовите Свойства: нет |
Политика данных
Весь код и данные обрабатываются и отображаются в браузере. Никакие данные не отправляются ни на один сервер.