Обзор
Диаграмма с областями, отображаемая в браузере с использованием 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([ ['Year', 'Sales', 'Expenses'], ['2013', 1000, 400], ['2014', 1170, 460], ['2015', 660, 1120], ['2016', 1030, 540] ]); var options = { title: 'Company Performance', hAxis: {title: 'Year', titleTextStyle: {color: '#333'}}, vAxis: {minValue: 0} }; var chart = new google.visualization.AreaChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 100%; height: 500px;"></div> </body> </html>
Области штабелирования
По умолчанию диаграмма с областями рисует ряды друг над другом. Вместо этого вы можете сложить их друг на друга, чтобы значения данных для каждого значения x суммировались. На диаграмме с областями значение каждой серии всегда будет располагаться относительно значения предыдущей серии. Объединение отрицательных и положительных значений приведет к перекрытию областей. Важно отметить, что опция interpolateNulls
не работает с диаграммами с областями с накоплением.
Слева для isStacked
установлено значение false (по умолчанию), а справа — значение true:
Обратите внимание, что порядок записей легенды отличается. На второй составной диаграмме порядок обратный: серия 0 размещается внизу, чтобы лучше соответствовать расположению элементов серии, благодаря чему легенда соответствует данным.
Диаграммы с областями с накоплением также поддерживают 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] } };
Предположим, что в одной из ваших серий нет данных для некоторых значений x. Например, на диаграммах выше предположим, что дроны не будут доступны до 2015 года, а сегвеи не будут доступны в 2014 году. Обратите внимание, что мы используем нулевые значения, когда данные отсутствуют, поэтому диаграмма будет выглядеть следующим образом:
Если эти разрывы не привлекают внимания, вы можете заменить нули нулями и/или установить для параметра interpolateNulls значение true:
Загрузка
Имя пакета google.charts.load
— "corechart".
google.charts.load("current", {packages: ["corechart"]});
Имя класса визуализации — google.visualization.AreaChart
.
var visualization = new google.visualization.AreaChart(container);
Формат данных
Строки: каждая строка в таблице представляет собой набор точек данных с одинаковым расположением по оси X.
Столбцы:
Столбец 0 | Столбец 1 | ... | Столбец N | |
---|---|---|---|---|
Цель: |
| Значения строки 1 | ... | Значения строки 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 | Функция замедления, примененная к анимации. Доступны следующие варианты:
Тип: строка По умолчанию: «линейный» |
анимация.стартап | Определяет, будет ли диаграмма анимироваться при первоначальном рисовании. Если Тип: логический По умолчанию ложь |
annotations.boxStyle | Для диаграмм, поддерживающих аннотации , объект var options = { annotations: { boxStyle: { // Color of the box outline. stroke: '#888', // Thickness of the box outline. strokeWidth: 1, // x-radius of the corner curvature. rx: 10, // y-radius of the corner curvature. ry: 10, // Attributes for linear gradient fill. gradient: { // Start color for gradient. color1: '#fbf6a7', // Finish color for gradient. color2: '#33b679', // Where on the boundary to start and // end the color1/color2 gradient, // relative to the upper left corner // of the boundary. x1: '0%', y1: '0%', x2: '100%', y2: '100%', // If true, the boundary for x1, // y1, x2, and y2 is the box. If // false, it's the entire chart. useObjectBoundingBoxUnits: true } } } }; В настоящее время этот параметр поддерживается для диаграмм с областями, гистограммами, столбцами, комбинированными, линейными и точечными диаграммами. Это не поддерживается аннотационной диаграммой . Тип: объект По умолчанию: ноль |
аннотации.данные | Для диаграмм, поддерживающих аннотации , объект annotations.datum позволяет переопределить выбор Google Charts для аннотаций, предоставляемых для отдельных элементов данных (например, значений, отображаемых на каждой полосе гистограммы). Вы можете управлять цветом с помощью annotations.datum.stem.color , длиной стебля с помощью annotations.datum.stem.length и стилем с помощью annotations.datum.style . Тип: объект По умолчанию: цвет «черный»; длина 12; стиль — «точка». |
аннотации.домен | Для диаграмм, поддерживающих аннотации , объект annotations.domain позволяет переопределить выбор Google Charts для аннотаций, предоставляемых для домена (основная ось диаграммы, например ось X на типичной линейной диаграмме). Вы можете управлять цветом с помощью annotations.domain.stem.color , длиной основы с помощью annotations.domain.stem.length и стилем с помощью annotations.domain.style . Тип: объект По умолчанию: цвет «черный»; длина 5; стиль — «точка». |
аннотации.highContrast | Для диаграмм, поддерживающих аннотации , логическое значение annotations.highContrast позволяет переопределить выбор цвета аннотации в Google Charts. По умолчанию annotations.highContrast имеет значение true, что заставляет диаграммы выбирать цвет аннотации с хорошей контрастностью: светлые цвета на темном фоне и темные на светлом. Если вы установите для annotations.highContrast значение false и не укажете собственный цвет аннотации, Google Charts будет использовать для аннотации цвет серии по умолчанию: Тип: логический По умолчанию: правда |
аннотации.стержень | Для диаграмм, поддерживающих аннотации , объект annotations.stem позволяет переопределить выбор Google Charts для стиля основы. Вы можете управлять цветом с помощью annotations.stem.color и длиной стебля с помощью annotations.stem.length . Обратите внимание, что параметр длины основы не влияет на аннотации со стилем 'line' : для аннотаций к базе 'line' длина основы всегда такая же, как и текст, а для аннотаций домена 'line' основа распространяется на всю диаграмму. . Тип: объект По умолчанию: цвет «черный»; длина равна 5 для аннотаций домена и 12 для аннотаций данных. |
аннотации.стиль | Для диаграмм, поддерживающих аннотации , параметр annotations.style позволяет переопределить выбор типа аннотации в Google Charts. Это может быть либо 'line' , либо 'point' . Тип: строка По умолчанию: «точка» |
аннотации.textStyle | Для диаграмм, поддерживающих аннотации , объект annotations.textStyle управляет внешним видом текста аннотации:var options = { annotations: { textStyle: { fontName: 'Times-Roman', fontSize: 18, bold: true, italic: true, // The color of the text. color: '#871b47', // The color of the text outline. auraColor: '#d799ae', // The transparency of the text. opacity: 0.8 } } }; В настоящее время этот параметр поддерживается для диаграмм с областями, гистограммами, столбцами, комбинированными, линейными и точечными диаграммами. Это не поддерживается аннотационной диаграммой . Тип: объект По умолчанию: ноль |
площадьНепрозрачность | Непрозрачность по умолчанию цветной области в серии диаграмм с областями, где 0,0 — полностью прозрачная, а 1,0 — полностью непрозрачная. Чтобы указать непрозрачность для отдельной серии, установите значение areaOpacity в свойстве Тип: число, 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, например: Тип: Массив строк. По умолчанию: цвета по умолчанию |
перекрестие | Объект, содержащий свойства перекрестия для диаграммы. Тип: объект По умолчанию: ноль |
перекрестие.цвет | Цвет перекрестия, выраженный либо в виде названия цвета (например, «синий»), либо в виде значения RGB (например, «#adf»). Тип: строка Тип: по умолчанию |
перекрестие.сосредоточено | Объект, содержащий свойства перекрестия при фокусировке. Тип: объект По умолчанию: по умолчанию |
перекрестие.непрозрачность | Непрозрачность перекрестия: Тип: номер По умолчанию: 1,0 |
перекрестие.ориентация | Ориентация перекрестия, которая может быть «вертикальной» только для вертикальных волосков, «горизонтальной» только для горизонтальных волосков или «обеими» для традиционных перекрестий. Тип: строка По умолчанию: «оба» |
перекрестие.выбрано | Объект, содержащий свойства перекрестия при выборе. Тип: объект По умолчанию: по умолчанию |
перекрестие.триггер | Когда отображать перекрестие: на Тип: строка По умолчанию: «оба» |
непрозрачность данных | Прозрачность точек данных: 1,0 означает полную непрозрачность, а 0,0 — полную прозрачность. В точечных, гистограммах, гистограммах и столбчатых диаграммах это относится к видимым данным: точкам на точечной диаграмме и прямоугольникам на остальных. В диаграммах, где выбор данных создает точку, например в линейных диаграммах и диаграммах с областями, это относится к кругам, которые появляются при наведении курсора или выборе. Комбинированная диаграмма демонстрирует оба поведения, и этот параметр не влияет на другие диаграммы. (Чтобы изменить непрозрачность линии тренда, см. раздел Непрозрачность линии тренда .) Тип: номер По умолчанию: 1,0 |
включитьИнтерактивность | Определяет ли диаграмма события, связанные с пользователем, или реагирует на взаимодействие с пользователем. Если значение равно 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 |
фокусЦель | Тип объекта, который получает фокус при наведении курсора мыши. Также влияет на то, какой объект выбирается щелчком мыши и какой элемент таблицы данных связан с событиями. Может быть одним из следующих:
В focusTarget «категория» всплывающая подсказка отображает все значения категории. Это может быть полезно для сравнения значений разных рядов. Тип: строка По умолчанию: «база данных» |
размер шрифта | Размер шрифта по умолчанию (в пикселях) для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы. Тип: номер По умолчанию: автоматический |
имя шрифта | Шрифт по умолчанию для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы. Тип: строка По умолчанию: «Ариал» |
сила IFrame | Рисует диаграмму внутри встроенного фрейма. (Обратите внимание, что в IE8 этот параметр игнорируется; все диаграммы IE8 рисуются в i-кадрах.) Тип: логический По умолчанию: ложь |
ось | Объект с элементами для настройки различных элементов горизонтальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Тип: объект По умолчанию: ноль |
hAxis.baseline | Базовая линия для горизонтальной оси. Эта опция поддерживается только для Тип: номер По умолчанию: автоматический |
hAxis.baselineColor | Цвет базовой линии горизонтальной оси. Может быть любой цветовой строкой HTML, например: Эта опция поддерживается только для Тип: номер По умолчанию: «черный» |
hAxis.direction | Направление роста значений по горизонтальной оси. Укажите Тип: 1 или -1 По умолчанию: 1 |
hAxis.format | Строка формата для числовых меток или меток оси дат. Для меток числовых осей это подмножество набора шаблонов десятичного форматирования ICU . Например,
Для меток оси даты это подмножество набора шаблонов форматирования даты ICU . Например, Фактическое форматирование, примененное к метке, определяется языковым стандартом, с которым был загружен API. Дополнительные сведения см. в разделе Загрузка диаграмм с определенной локалью . При вычислении значений делений и линий сетки будут рассматриваться несколько альтернативных комбинаций всех соответствующих вариантов линий сетки, и альтернативы будут отклонены, если отформатированные метки делений будут дублироваться или перекрываться. Таким образом, вы можете указать Эта опция поддерживается только для Тип: строка По умолчанию: авто |
hAxis.gridlines | Объект со свойствами для настройки линий сетки на горизонтальной оси. Обратите внимание, что линии сетки по горизонтальной оси рисуются вертикально. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {color: '#333', minSpacing: 20} Эта опция поддерживается только для Тип: объект По умолчанию: ноль |
hAxis.gridlines.color | Цвет горизонтальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML. Тип: строка По умолчанию: '#CCC' |
hAxis.gridlines.count | Примерное количество горизонтальных линий сетки внутри области диаграммы. Если вы укажете положительное число для Тип: номер По умолчанию: -1 |
hAxis.gridlines.interval | Массив размеров (в виде значений данных, а не пикселей) между соседними линиями сетки. В настоящее время эта опция предназначена только для числовых осей, но она аналогична опциям Тип: число от 1 до 10, не включая 10. По умолчанию: вычисляется |
hAxis.gridlines.minSpacing | Минимальное пространство экрана в пикселях между основными линиями сетки hAxis. По умолчанию для основных линий сетки установлено значение Тип: номер По умолчанию: вычисляется |
hAxis.gridlines.multiple | Все значения линий сетки и делений должны быть кратны значению этого параметра. Обратите внимание, что, в отличие от интервалов, степени, кратные 10, не учитываются. Таким образом, вы можете заставить такты быть целыми числами, указав Тип: номер По умолчанию: 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.interval | Параметр majorGridlines.interval аналогичен параметру интервала основных линий сетки, но выбранный интервал всегда будет четным делителем интервала основных линий сетки. Интервал по умолчанию для линейных масштабов — Тип: номер По умолчанию: 1 |
hAxis.minorGridlines.minSpacing | Минимально необходимое пространство в пикселях между соседними второстепенными линиями сетки, а также между второстепенными и основными линиями сетки. Значение по умолчанию составляет 1/2 minSpacing основных линий сетки для линейных масштабов и 1/5 minSpacing для логарифмических масштабов. Тип: номер По умолчанию: вычисляется |
hAxis.minorGridlines.multiple | То же, что и для основных Тип: номер По умолчанию: 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 будет автоматически расширен, чтобы включить минимальные и максимальные отметки, если вы не укажете Примеры:
Эта опция поддерживается только для Тип: Массив элементов По умолчанию: авто |
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.maxValue | Перемещает максимальное значение горизонтальной оси на указанное значение; на большинстве графиков это будет вправо. Игнорируется, если для этого параметра установлено значение меньше максимального значения x данных. Эта опция поддерживается только для Тип: номер По умолчанию: автоматический |
hAxis.minValue | Перемещает минимальное значение горизонтальной оси на указанное значение; на большинстве графиков это будет левое положение. Игнорируется, если для этого параметра установлено значение, превышающее минимальное значение x данных. Эта опция поддерживается только для Тип: номер По умолчанию: автоматический |
hAxis.viewWindowMode | Указывает, как масштабировать горизонтальную ось для отображения значений в области диаграммы. Поддерживаются следующие строковые значения:
Эта опция поддерживается только для Тип: строка По умолчанию: эквивалент «pretty», но haxis.viewWindow.min и haxis.viewWindow.max имеют приоритет, если они используются. |
hAxis.viewWindow | Указывает диапазон обрезки горизонтальной оси. Тип: объект По умолчанию: ноль |
hAxis.viewWindow.max |
Игнорируется, когда Тип: номер По умолчанию: авто |
hAxis.viewWindow.min |
Игнорируется, когда Тип: номер По умолчанию: авто |
высота | Высота диаграммы в пикселях. Тип: номер По умолчанию: высота содержащего элемента. |
интерполироватьNulls | Стоит ли угадывать стоимость недостающих очков. Если это правда, он угадает значение любых недостающих данных на основе соседних точек. Если значение равно false, в неизвестной точке останется разрыв строки. Это не поддерживается диаграммами с областями с параметром Тип: логический По умолчанию: ложь |
isStacked | Если установлено значение true, элементы для всех серий складываются в каждое значение домена. Примечание. В диаграммах «Столбец» , «Область» и «Ступенчатая область» Google Charts меняет порядок элементов легенды на обратный, чтобы лучше соответствовать расположению элементов серии (например, серия 0 будет самым нижним элементом легенды). Это не относится к гистограммам . Параметр Параметры
При 100% суммировании расчетное значение для каждого элемента появится во всплывающей подсказке после его фактического значения. Целевая ось по умолчанию будет отображать значения деления на основе относительной шкалы 0–1 в виде долей от 1 для 100-процентное стекирование поддерживает только значения данных типа Тип: логическое значение/строка По умолчанию: ложь |
легенда | Объект с членами для настройки различных аспектов легенды. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {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>} |
линияDashStyle | Схема включения и выключения пунктирных линий. Например, Тип: Массив чисел По умолчанию: ноль |
ширина линии | Ширина линии данных в пикселях. Используйте ноль, чтобы скрыть все линии и показать только точки. Вы можете переопределить значения для отдельных серий, используя свойство Тип: номер По умолчанию: 2 |
ориентация | Ориентация диаграммы. Если установлено значение Тип: строка По умолчанию: «горизонтально» |
точкаФорма | Форма отдельных элементов данных: «круг», «треугольник», «квадрат», «ромб», «звезда» или «многоугольник». Примеры см. в документации по точкам . Тип: строка По умолчанию: «круг» |
размер точки | Диаметр отображаемых точек в пикселях. Используйте ноль, чтобы скрыть все точки. Вы можете переопределить значения для отдельных серий, используя свойство Тип: номер По умолчанию: 0 |
точкивидимые | Определяет, будут ли отображаться точки. Установите значение Это также можно переопределить с помощью роли стиля в форме Тип: логический По умолчанию: правда |
обратныеКатегории | Если установлено значение true, серия будет рисоваться справа налево. По умолчанию рисование осуществляется слева направо. Эта опция поддерживается только для Тип: логический По умолчанию: ложь |
режим выбора | Если Тип: строка По умолчанию: «одиночный» |
ряд | Массив объектов, каждый из которых описывает формат соответствующей серии на диаграмме. Чтобы использовать значения по умолчанию для серии, укажите пустой объект {}. Если серия или значение не указаны, будет использоваться глобальное значение. Каждый объект поддерживает следующие свойства:
Вы можете указать либо массив объектов, каждый из которых относится к серии в данном порядке, либо вы можете указать объект, в котором у каждого ребенка есть числовое ключ, указывающий, к какой серии он применим. Например, следующие два заявления идентичны и объявляют первую серию черной и отсутствующей в легенде, а четвертый - красный и отсутствующий от легенды: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } Тип: массив объектов или объект с вложенными объектами По умолчанию: {} |
тема | Тема - это набор предопределенных значений опции, которые работают вместе для достижения конкретного поведения в диаграмме или визуального эффекта. В настоящее время доступна только одна тема:
Тип: строка По умолчанию: ноль |
заголовок | Текст для отображения над диаграммой. Тип: строка По умолчанию: без заголовка |
TitlePosition | Где разместить титул диаграммы, по сравнению с областью диаграммы. Поддерживаемые значения:
Тип: строка По умолчанию: 'out' |
titletextstyle | Объект, который указывает стиль текста заголовка. Объект имеет такой формат: { 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 | Если это правда, покажите цветные квадраты рядом с информацией серии в подсказке. По умолчанию верно, когда Тип: логический По умолчанию: автоматический |
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 } ] Тип: массив объекта или объект с дочерними объектами По умолчанию: ноль |
Vaxis | Объект с членами для настройки различных элементов вертикальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь: {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.interval | Массив размеров (как значения данных, а не пиксели) между соседними сетками. В настоящее время эта опция предназначена только для числовых осей, но она аналогична опциям Тип: номер от 1 до 10, не включая 10. По умолчанию: вычисляется |
vaxis.gridlines.minspacing | Минимальное пространство экрана в пикселях, между основными сетками Haxis. По умолчанию для основных сетки составляет Тип: номер По умолчанию: вычисляется |
vaxis.gridlines.multiple | Все значения сетки и клещей должны быть кратными значения этой опции. Обратите внимание, что, в отличие от интервалов, силы в 10 раз больше, чем множественные, не учитываются. Таким образом, вы можете заставить клещей быть целыми числами, указав Тип: номер По умолчанию: 1 |
vaxis.gridlines.units | Переопределяет формат по умолчанию для различных аспектов даты/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.interval | Опция MinorGridlines.Interval похожа на основной вариант интервала сетки, но выбранный интервал всегда будет ровным делителем основного интервала сетки. Интервал по умолчанию для линейных масштабов составляет Тип: номер По умолчанию: 1 |
vaxis.minorgridlines.minspacing | Минимальное требуемое пространство в пикселях, между соседними незначительными сетками и между незначительными и основными сетками. Значение по умолчанию составляет 1/2 майки основных линий сетки для линейных шкал и 1/5 Minspacing для шкал журналов. Тип: номер По умолчанию: вычисляется |
vaxis.minorgridlines.multiple | То же, что и для основных Тип: номер По умолчанию: 1 |
vaxis.minorgridlines.count | Опция MinorGridlines.count в основном устарел, за исключением отключения незначительных сетей, устанавливая счет на 0. Количество незначительных линий сетки зависит от интервала между основными сетками (см. Vaxis.Gridlines.Interval) и минимально требуемое пространство (см. Vaxis. Minorgridlines.minspacing). Тип: номер По умолчанию: 1 |
vaxis.minorgridlines.units | Переопределяет формат по умолчанию для различных аспектов даты/DateTime/TimeOfday Tipes, когда используется с диаграммой вычисленной миноргидлины. Позволяет форматировать в течение многих лет, месяцев, дней, часов, минут, секунд и миллисекундов. Общий формат: 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 | Положение текста вертикальной оси относительно области диаграммы. Поддерживаемые значения: «out», «в», «нет». Тип: строка По умолчанию: 'out' |
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-ось 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 | Перемещает значение MIN вертикальной оси к указанному значению; Это будет вниз в большинстве графиков. Игнорируется, если это установлено значение, превышающему минимальное значение y данных. Тип: номер По умолчанию: ноль |
vaxis.viewwindowmode | Указывает, как масштабировать вертикальную ось, чтобы отобразить значения в области диаграммы. Поддерживаются следующие строковые значения:
Тип: строка По умолчанию: эквивалент «красиво», но 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) | Возвращает Pixel X-координату Пример: Вызовите это после того, как диаграмма будет нарисована. Возврат тип: номер |
getYLocation(dataValue, optional_axis_index) | Возвращает Pixel Y-координату Пример: Вызовите это после того, как диаграмма будет нарисована. Возврат тип: номер |
removeAction(actionID) | Удаляет действие подсказки инструментов с помощью запрошенного Тип возврата: none |
setAction(action) | Устанавливает действие подсказки инструментов для выполнения, когда пользователь нажимает на текст действия. Метод Любые действия по всплеске инструментов должны быть установлены до вызова метода Тип возврата: none |
setSelection() | Выбирает указанные объекты диаграммы. Отменяет любой предыдущий выбор. Выбираемые сущности - это точки, аннотации, записи легенды и категории. Точка или аннотация соответствуют ячейке в таблице данных, ввод легенды в столбце (индекс строки равен нулю), а категория к строке (индекс столбца - нулевой). Для этой диаграммы одновременно можно выбрать только одну сущность. Тип возврата: нет |
clearChart() | Очищает диаграмму и освобождает все выделенные ей ресурсы. Тип возврата: нет |
События
Для получения дополнительной информации о том, как использовать эти события, см. Базовую интерактивность , обработку событий и стрельбы .
Имя | |
---|---|
animationfinish | Уволен, когда переходная анимация завершена. Свойства: нет |
click | Запускается, когда пользователь щелкнет внутри диаграммы. Можно использовать для определения того, когда нажимают заголовок, элементы данных, записи легенды, оси, сетки или метки. Свойства: TargetId |
error | Вызывается, когда возникает ошибка при попытке отобразить диаграмму. Свойства: идентификатор, сообщение |
legendpagination | Запускается, когда пользователь нажимает стрелки Legend Pagination. Обращает обратно текущий индекс страниц на основе нуля и общее количество страниц. Свойства: CurrentPageIndex, TotalPages |
onmouseover | Вызывается, когда пользователь наводит указатель мыши на визуальный объект. Возвращает индексы строк и столбцов соответствующего элемента таблицы данных. Свойства: строка, столбец |
onmouseout | Вызывается, когда пользователь уводит указатель мыши от визуального объекта. Возвращает индексы строк и столбцов соответствующего элемента таблицы данных. Свойства: строка, столбец |
ready | Диаграмма готова для вызовов внешних методов. Если вы хотите взаимодействовать с диаграммой и вызывать методы после ее рисования, вам следует настроить прослушиватель этого события до вызова метода Свойства: нет |
select | Запускается, когда пользователь щелкает визуальный объект. Чтобы узнать, что было выбрано, вызовите Свойства: нет |
Политика данных
Весь код и данные обрабатываются и отображаются в браузере. Никакие данные не отправляются ни на один сервер.