Визуализация: пузырьковая диаграмма

Обзор

Пузырьковая диаграмма, отображаемая в браузере с использованием 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 Либо идентификатор серии, либо значение, представляющее цвет по градиентной шкале, в зависимости от типа столбца:
  • нить
    Строка, идентифицирующая пузырьки в одной серии. Используйте одно и то же значение для идентификации всех пузырьков, принадлежащих к одной серии; пузырьки в одной серии будут иметь один и тот же цвет. Серию можно настроить с помощью опции series .
  • число
    Значение, которое сопоставляется с фактическим цветом по градиентной шкале с помощью параметра colorAxis .
Размер; значения в этом столбце сопоставляются с фактическими значениями пикселей с помощью параметра sizeAxis .
Тип данных: нить число число строка или число число

Параметры конфигурации

Имя
анимация.длительность

Продолжительность анимации в миллисекундах. Подробности смотрите в документации по анимации .

Тип: номер
По умолчанию: 0
анимация.easing

Функция замедления, примененная к анимации. Доступны следующие варианты:

  • «линейный» — постоянная скорость.
  • 'in' - Легкость - Начинайте медленно и ускоряйтесь.
  • 'out' - Успокойтесь - Начинайте быстро и замедляйтесь.
  • «inAndOut» — легкость входа и выхода — начинайте медленно, ускоряйтесь, затем замедляйтесь.
Тип: строка
По умолчанию: «линейный»
анимация.стартап

Определяет, будет ли диаграмма анимироваться при первоначальном рисовании. Если true , диаграмма начнется с базовой линии и анимируется до конечного состояния.

Тип: логический
По умолчанию ложь
осьНазванияПозиция

Где разместить заголовки осей по сравнению с областью диаграммы. Поддерживаемые значения:

  • in — Нарисуйте заголовки осей внутри области диаграммы.
  • out — вывести заголовки осей за пределы области диаграммы.
  • нет — пропустить названия осей.
Тип: строка
По умолчанию: «выход»
фоновый цвет

Цвет фона основной области диаграммы. Это может быть либо простая цветовая строка HTML, например: 'red' или '#00cc00' , либо объект со следующими свойствами.

Тип: строка или объект
По умолчанию: «белый»
фонЦвет.обводка

Цвет границы диаграммы в виде цветовой строки HTML.

Тип: строка
По умолчанию: '#666'
backgroundColor.strokeWidth

Ширина границы в пикселях.

Тип: номер
По умолчанию: 0
фонЦвет.заливка

Цвет заливки диаграммы в виде цветовой строки HTML.

Тип: строка
По умолчанию: «белый»
пузырь

Объект с членами для настройки визуальных свойств пузырьков.

Тип: объект
По умолчанию: ноль
пузырь.непрозрачность

Непрозрачность пузырьков, где 0 — полностью прозрачный, а 1 — полностью непрозрачный.

Тип: число от 0,0 до 1,0.
По умолчанию: 0,8
пузырь.удар

Цвет обводки пузырьков.

Тип: строка
По умолчанию: '#ccc'
bubble.textStyle

Объект, определяющий стиль пузырькового текста. Объект имеет такой формат:

{color: <string>, fontName: <string>, fontSize: <number>}

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
область диаграммы

Объект с элементами для настройки размещения и размера области диаграммы (где рисуется сама диаграмма, исключая оси и легенды). Поддерживаются два формата: число или число, за которым следует %. Простое число — это значение в пикселях; число, за которым следует %, представляет собой процент. Пример: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Тип: объект
По умолчанию: ноль
chartArea.backgroundColor
Цвет фона области диаграммы. Когда используется строка, это может быть либо шестнадцатеричная строка (например, «#fdc»), либо название цвета на английском языке. При использовании объекта могут быть предоставлены следующие свойства:
  • stroke : цвет, представленный в виде шестнадцатеричной строки или английского названия цвета.
  • strokeWidth : если предусмотрено, рисует границу вокруг области диаграммы заданной ширины (и с цветом stroke ).
Тип: строка или объект
По умолчанию: «белый»
диаграммаArea.left

Насколько далеко рисовать диаграмму от левой границы.

Тип: число или строка.
По умолчанию: авто
диаграммаArea.top

На каком расстоянии рисовать диаграмму от верхней границы.

Тип: число или строка.
По умолчанию: авто
ChartArea.width

Ширина области диаграммы.

Тип: число или строка.
По умолчанию: авто
диаграммаArea.height

Высота области диаграммы.

Тип: число или строка.
По умолчанию: авто
цвета

Цвета, используемые для элементов диаграммы. Массив строк, где каждый элемент представляет собой строку цвета HTML, например: colors:['red','#004411'] .

Тип: Массив строк.
По умолчанию: цвета по умолчанию
цветОсь

Объект, определяющий сопоставление между значениями столбца цвета и цветами или шкалой градиента. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь:

 {minValue: 0,  colors: ['#FF0000', '#00FF00']}
Тип: объект
По умолчанию: ноль
colorAxis.minValue

Если присутствует, указывает минимальное значение для данных цвета диаграммы. Значения цветовых данных этого значения и ниже будут отображаться как первый цвет в диапазоне colorAxis.colors .

Тип: номер
По умолчанию: минимальное значение столбца цвета в данных диаграммы.
цветAxis.maxValue

Если присутствует, указывает максимальное значение для данных цвета диаграммы. Значения цветовых данных этого значения и выше будут отображаться как последний цвет в диапазоне colorAxis.colors .

Тип: номер
По умолчанию: максимальное значение столбца цвета в данных диаграммы.
colorAxis.values

Если присутствует, управляет тем, как значения связаны с цветами. Каждое значение связано с соответствующим цветом в массиве colorAxis.colors . Эти значения применяются к данным цвета диаграммы. Окраска производится согласно градиенту указанных здесь значений. Отсутствие указания значения для этой опции эквивалентно указанию [minValue, maxValue].

Тип: массив чисел
По умолчанию: ноль
colorAxis.colors

Цвета для назначения значениям в визуализации. Массив строк, где каждый элемент представляет собой строку цвета HTML, например: colorAxis: {colors:['red','#004411']} . У вас должно быть как минимум два значения; градиент будет включать в себя все ваши значения, а также вычисленные промежуточные значения, причем первый цвет будет наименьшим значением, а последний цвет — самым высоким.

Тип: массив цветных строк.
По умолчанию: ноль
colorAxis.legend

Объект, определяющий стиль легенды цвета градиента.

Тип: объект
По умолчанию: ноль
colorAxis.legend.position

Позиция легенды. Может быть одним из следующих:

  • 'top' - Над графиком.
  • «дно» — под графиком.
  • 'in' - Внутри графика, вверху.
  • 'none' — легенда не отображается.
Тип: объект
По умолчанию: «сверху»
colorAxis.legend.textStyle

Объект, определяющий стиль текста легенды. Объект имеет такой формат:

{color: <string>, fontName: <string>, fontSize: <number>}

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
colorAxis.legend.numberFormat

Строка формата для числовых меток. Это подмножество набора шаблонов ICU . Например, {numberFormat:'.##'} будет отображать значения «10,66», «10,6» и «10,0» для значений 10,666, 10,6 и 10.

Тип: строка
По умолчанию: авто
включитьИнтерактивность

Определяет ли диаграмма события, связанные с пользователем, или реагирует на взаимодействие с пользователем. Если установлено значение false, диаграмма не будет генерировать события «выбор» или другие события, основанные на взаимодействии (но будет генерировать события готовности или ошибки), а также не будет отображать наводящий текст или иным образом изменяться в зависимости от ввода пользователя.

Тип: логический
По умолчанию: правда
исследователь

Опция explorer позволяет пользователям панорамировать и масштабировать диаграммы Google. explorer: {} обеспечивает поведение проводника по умолчанию, позволяя пользователям перемещаться по горизонтали и вертикали путем перетаскивания, а также увеличивать и уменьшать масштаб путем прокрутки.

Эта функция является экспериментальной и может измениться в будущих выпусках.

Примечание. Проводник работает только с непрерывными осями (например, числами или датами).

Тип: объект
По умолчанию: ноль
explorer.actions

Обозреватель Google Charts поддерживает три действия:

  • dragToPan : перетаскивайте диаграмму для перемещения по горизонтали и вертикали. Для панорамирования только по горизонтальной оси используйте explorer: { axis: 'horizontal' } . Аналогично для вертикальной оси.
  • dragToZoom : поведение проводника по умолчанию — увеличение и уменьшение масштаба при прокрутке пользователем. Если используется explorer: { actions: ['dragToZoom', 'rightClickToReset'] } , перетаскивание по прямоугольной области увеличивает масштаб этой области. Мы рекомендуем использовать rightClickToReset всякий раз, когда используется dragToZoom . См. explorer.maxZoomIn , explorer.maxZoomOut и explorer.zoomDelta для настройки масштабирования.
  • rightClickToReset : щелчок правой кнопкой мыши по диаграмме возвращает ее к исходному уровню панорамирования и масштабирования.
Тип: Массив строк.
По умолчанию: ['dragToPan', 'rightClickToReset']
explorer.axis

По умолчанию пользователи могут панорамировать как по горизонтали, так и по вертикали, когда используется опция explorer . Если вы хотите, чтобы пользователи могли панорамировать только по горизонтали, используйте explorer: { axis: 'horizontal' } . Аналогично, explorer: { axis: 'vertical' } включает только вертикальное панорамирование.

Тип: строка
По умолчанию: горизонтальное и вертикальное панорамирование.
explorer.keepInBounds

По умолчанию пользователи могут панорамировать все вокруг, независимо от того, где находятся данные. Чтобы гарантировать, что пользователи не выходят за пределы исходной диаграммы, используйте explorer: { keepInBounds: true } .

Тип: логический
По умолчанию: ложь
explorer.maxZoomIn

Максимальное увеличение, которое может увеличить проводник. По умолчанию пользователи смогут увеличить масштаб настолько, что смогут видеть только 25 % исходного изображения. Настройка explorer: { maxZoomIn: .5 } позволит пользователям увеличивать масштаб только настолько, чтобы увидеть половину исходного изображения.

Тип: номер
По умолчанию: 0,25
explorer.maxZoomOut

Максимум, на который может уменьшить масштаб проводник. По умолчанию пользователи смогут уменьшить масштаб настолько, что диаграмма будет занимать только 1/4 доступного пространства. Настройка explorer: { maxZoomOut: 8 } позволит пользователям уменьшать масштаб настолько, что диаграмма будет занимать только 1/8 доступного пространства.

Тип: номер
По умолчанию: 4
explorer.zoomDelta

Когда пользователи увеличивают или уменьшают масштаб, explorer.zoomDelta определяет, насколько они увеличивают масштаб. Чем меньше число, тем плавнее и медленнее масштабирование.

Тип: номер
По умолчанию: 1,5
размер шрифта

Размер шрифта по умолчанию (в пикселях) для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы.

Тип: номер
По умолчанию: автоматический
имя шрифта

Шрифт по умолчанию для всего текста на диаграмме. Вы можете переопределить это, используя свойства для определенных элементов диаграммы.

Тип: строка
По умолчанию: «Ариал»
сила IFrame

Рисует диаграмму внутри встроенного фрейма. (Обратите внимание, что в IE8 этот параметр игнорируется; все диаграммы IE8 рисуются в i-кадрах.)

Тип: логический
По умолчанию: ложь
ось

Объект с элементами для настройки различных элементов горизонтальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Тип: объект
По умолчанию: ноль
hAxis.baseline

Базовая линия для горизонтальной оси.

Тип: номер
По умолчанию: автоматический
hAxis.baselineColor

Цвет базовой линии горизонтальной оси. Может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' .

Тип: номер
По умолчанию: «черный»
hAxis.direction

Направление роста значений по горизонтальной оси. Укажите -1 , чтобы изменить порядок значений.

Тип: 1 или -1
По умолчанию: 1
hAxis.format

Строка формата для меток числовых осей. Это подмножество набора шаблонов ICU . Например, {format:'#,###%'} будет отображать значения «1000%», «750%» и «50%» для значений 10, 7,5 и 0,5. Вы также можете предоставить что-либо из следующего:

  • {format: 'none'} : отображает числа без форматирования (например, 8000000).
  • {format: 'decimal'} : отображает числа с разделителями тысяч (например, 8 000 000).
  • {format: 'scientific'} : отображает числа в экспоненциальном формате (например, 8e6).
  • {format: 'currency'} : отображает числа в местной валюте (например, 8 000 000,00 долларов США).
  • {format: 'percent'} : отображает числа в процентах (например, 800 000 000%).
  • {format: 'short'} : отображает сокращенные номера (например, 8M)
  • {format: 'long'} : отображает числа как полные слова (например, 8 миллионов).

Фактическое форматирование, примененное к метке, определяется языковым стандартом, с которым был загружен API. Дополнительные сведения см. в разделе Загрузка диаграмм с определенной локалью .

При вычислении значений делений и линий сетки будут рассматриваться несколько альтернативных комбинаций всех соответствующих вариантов линий сетки, и альтернативы будут отклонены, если отформатированные метки делений будут дублироваться или перекрываться. Таким образом, вы можете указать format:"#" если хотите отображать только целочисленные значения делений, но имейте в виду, что если ни одна альтернатива не удовлетворяет этому условию, ни линии сетки, ни деления отображаться не будут.

Тип: строка
По умолчанию: авто
hAxis.gridlines

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

{color: '#333', minSpacing: 20}
Тип: объект
По умолчанию: ноль
hAxis.gridlines.color

Цвет горизонтальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML.

Тип: строка
По умолчанию: '#CCC'
hAxis.gridlines.count

Примерное количество горизонтальных линий сетки внутри области диаграммы. Если вы укажете положительное число для gridlines.count , оно будет использоваться для вычисления minSpacing между линиями сетки. Вы можете указать значение 1 , чтобы рисовать только одну линию сетки, или 0 , чтобы линии сетки не отображались. Укажите -1 (значение по умолчанию), чтобы автоматически вычислить количество линий сетки на основе других параметров.

Тип: номер
По умолчанию: -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

Параметр minorGridlines.count по большей части устарел, за исключением отключения второстепенных линий сетки путем установки счетчика равным 0. Количество второстепенных линий сетки теперь полностью зависит от интервала между основными линиями сетки (см. hAxis.gridlines.interval ) и минимально необходимого пространства (см. hAxis.minorGridlines.minSpacing ).

Тип: номер
По умолчанию: 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 , которое преобразует горизонтальную ось в логарифмический масштаб (требуется, чтобы все значения были положительными). Установите значение true для «да».

Тип: логический
По умолчанию: ложь
hAxis.scaleType

Свойство hAxis , которое преобразует горизонтальную ось в логарифмический масштаб. Может быть одним из следующих:

  • null — логарифмическое масштабирование не выполняется.
  • 'log' - логарифмическое масштабирование. Отрицательные и нулевые значения не отображаются. Этот параметр аналогичен настройке hAxis: { logscale: true } .
  • 'mirrorLog' — логарифмическое масштабирование, при котором отображаются отрицательные и нулевые значения. Нанесенное на график значение отрицательного числа является отрицательным логарифмом абсолютного значения. Значения, близкие к 0, отображаются в линейном масштабе.
Тип: строка
По умолчанию: ноль
hAxis.textPosition

Положение текста по горизонтальной оси относительно области диаграммы. Поддерживаемые значения: «вне», «вход», «нет».

Тип: строка
По умолчанию: «выход»
hAxis.textStyle

Объект, определяющий стиль текста по горизонтальной оси. Объект имеет такой формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.ticks

Заменяет автоматически сгенерированные отметки оси X указанным массивом. Каждый элемент массива должен быть либо допустимым значением тика (например, числом, датой, датой и временем или днем), либо объектом. Если это объект, он должен иметь свойство v для значения отметки и необязательное свойство f , содержащее литеральную строку, которая будет отображаться в качестве метки.

ViewWindow будет автоматически расширен, чтобы включить отметки min и max, если вы не укажете viewWindow.min или viewWindow.max для переопределения.

Примеры:

  • hAxis: { ticks: [5,10,15,20] }
  • hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
  • hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
  • hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }
Тип: Массив элементов
По умолчанию: авто
hAxis.title

Свойство hAxis , определяющее заголовок горизонтальной оси.

Тип: строка
По умолчанию: ноль
hAxis.titleTextStyle

Объект, определяющий стиль текста заголовка по горизонтальной оси. Объект имеет такой формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.maxValue

Перемещает максимальное значение горизонтальной оси на указанное значение; на большинстве графиков это будет вправо. Игнорируется, если для этого параметра установлено значение меньше максимального значения x данных. hAxis.viewWindow.max переопределяет это свойство.

Тип: номер
По умолчанию: автоматический
hAxis.minValue

Перемещает минимальное значение горизонтальной оси на указанное значение; на большинстве графиков это будет левое положение. Игнорируется, если для этого параметра установлено значение, превышающее минимальное значение x данных. hAxis.viewWindow.min переопределяет это свойство.

Тип: номер
По умолчанию: автоматический
hAxis.viewWindowMode

Указывает, как масштабировать горизонтальную ось для отображения значений в области диаграммы. Поддерживаются следующие строковые значения:

  • «красиво» — масштабируйте горизонтальные значения так, чтобы максимальные и минимальные значения данных отображались немного внутри левой и правой части области диаграммы. Окно просмотра расширяется до ближайшей основной линии сетки для чисел или ближайшей второстепенной линии сетки для дат и времени.
  • «максимизировано» — масштабируйте горизонтальные значения так, чтобы максимальные и минимальные значения данных касались левой и правой части области диаграммы. Это приведет к игнорированию haxis.viewWindow.min и haxis.viewWindow.max .
  • «явный» — устаревший параметр для указания значений левого и правого масштаба области диаграммы. (Устарело, поскольку оно избыточно для haxis.viewWindow.min и haxis.viewWindow.max .) Значения данных за пределами этих значений будут обрезаны. Вы должны указать объект hAxis.viewWindow описывающий максимальное и минимальное отображаемые значения.
Тип: строка
По умолчанию: эквивалент «pretty», но haxis.viewWindow.min и haxis.viewWindow.max имеют приоритет, если они используются.
hAxis.viewWindow

Указывает диапазон обрезки горизонтальной оси.

Тип: объект
По умолчанию: ноль
hAxis.viewWindow.max

Максимальное значение горизонтальных данных для визуализации.

Игнорируется, когда hAxis.viewWindowMode имеет значение «красивый» или «максимальный».

Тип: номер
По умолчанию: авто
hAxis.viewWindow.min

Минимальное значение горизонтальных данных для визуализации.

Игнорируется, когда hAxis.viewWindowMode имеет значение «красивый» или «максимальный».

Тип: номер
По умолчанию: авто
высота

Высота диаграммы в пикселях.

Тип: номер
По умолчанию: высота содержащего элемента.
легенда

Объект с членами для настройки различных аспектов легенды. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Тип: объект
По умолчанию: ноль
легенда.выравнивание

Согласование легенды. Может быть одним из следующих:

  • «Начало» — выравнивается по началу области, выделенной для легенды.
  • 'center' — центрируется в области, отведенной для легенды.
  • «конец» — выравнивается по концу области, выделенной для легенды.

Начало, центр и конец зависят от стиля легенды (вертикального или горизонтального). Например, в «правой» легенде «начало» и «конец» находятся вверху и внизу соответственно; для «верхней» легенды «начало» и «конец» будут находиться слева и справа от области соответственно.

Значение по умолчанию зависит от положения легенды. Для «нижних» легенд по умолчанию используется «центр»; другие легенды по умолчанию имеют значение «старт».

Тип: строка
По умолчанию: автоматический
легенда.maxLines

Максимальное количество строк в легенде. Установите для этого числа значение больше единицы, чтобы добавить строки в легенду. Примечание. Точная логика, используемая для определения фактического количества отображаемых строк, все еще находится в стадии разработки.

В настоящее время эта опция работает только тогда, когда Legend.position имеет значение «top».

Тип: номер
По умолчанию: 1
легенда.pageIndex

Начальный выбранный индекс страницы легенды, отсчитываемый от нуля.

Тип: номер
По умолчанию: 0
легенда.позиция

Позиция легенды. Может быть одним из следующих:

  • «дно» — под графиком.
  • «left» — слева от диаграммы, при условии, что с левой осью не связана никакая серия. Поэтому, если вам нужна легенда слева, используйте опцию targetAxisIndex: 1 .
  • 'in' — внутри диаграммы, в верхнем левом углу.
  • 'none' — легенда не отображается.
  • 'right' - Справа от диаграммы. Несовместимо с опцией vAxes .
  • 'top' - Над графиком.
Тип: строка
По умолчанию: «право»
Legend.textStyle

Объект, определяющий стиль текста легенды. Объект имеет такой формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
режим выбора

Если selectionMode имеет значение 'multiple' , пользователи могут выбрать несколько точек данных.

Тип: строка
По умолчанию: «одиночный»
ряд

Объект объектов, ключами которого являются названия серий (значения в столбце Цвет) и каждый объект, описывающий формат соответствующей серии на диаграмме. Если серия или значение не указаны, будет использоваться глобальное значение. Каждый объект поддерживает следующие свойства:

  • color — цвет, используемый для этой серии. Укажите допустимую цветовую строку HTML.
  • visibleInLegend — логическое значение, где true означает, что серия должна иметь запись легенды, а false означает, что ее не должно быть. По умолчанию верно.
Пример:
series: {'Europe': {color: 'green'}}
Тип: Объект с вложенными объектами.
По умолчанию: {}
размерОсь

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

 {minValue: 0,  maxSize: 20}
Тип: объект
По умолчанию: ноль
sizeAxis.maxSize

Максимальный радиус максимально возможного пузырька в пикселях.

Тип: номер
По умолчанию: 30
sizeAxis.maxValue

Значение размера (как показано в данных диаграммы), которое должно быть сопоставлено с sizeAxis.maxSize . Большие значения будут обрезаны до этого значения.

Тип: номер
По умолчанию: максимальное значение столбца размера в данных диаграммы.
sizeAxis.minSize

Минимальный радиус наименьшего возможного пузырька в пикселях.

Тип: номер
По умолчанию: 5
sizeAxis.minValue

Значение размера (как показано в данных диаграммы), которое должно быть сопоставлено с sizeAxis.minSize . Меньшие значения будут обрезаны до этого значения.

Тип: номер
По умолчанию: минимальное значение столбца размера в данных диаграммы.
сортировкаПузыриПоРазмеру

Если это правда, пузырьки сортируются по размеру, чтобы пузырьки меньшего размера располагались над пузырьками большего размера. Если установлено значение false, пузырьки сортируются в соответствии с их порядком в DataTable.

Тип: логический
По умолчанию: правда
тема

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

  • «максимизировано» — увеличивает область диаграммы и рисует легенду и все метки внутри области диаграммы. Устанавливает следующие параметры:
    chartArea: {width: '100%', height: '100%'},
    legend: {position: 'in'},
    titlePosition: 'in', axisTitlesPosition: 'in',
    hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
            
Тип: строка
По умолчанию: ноль
заголовок

Текст для отображения над диаграммой.

Тип: строка
По умолчанию: без названия
НазваниеПозиция

Где разместить заголовок диаграммы по сравнению с областью диаграммы. Поддерживаемые значения:

  • in — Нарисуйте заголовок внутри области диаграммы.
  • out — вывести заголовок за пределы области диаграммы.
  • нет – опустите заголовок.
Тип: строка
По умолчанию: «выход»
заголовокTextStyle

Объект, определяющий стиль текста заголовка. Объект имеет такой формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {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 может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
подсказка.триггер

Взаимодействие пользователя, вызывающее отображение всплывающей подсказки:

  • «фокус» — всплывающая подсказка будет отображаться, когда пользователь наводит курсор на элемент.
  • «нет» — всплывающая подсказка не будет отображаться.
  • «выбор» — всплывающая подсказка будет отображаться, когда пользователь выбирает элемент.
Тип: строка
По умолчанию: «фокус»
вАксис

Объект с элементами для настройки различных элементов вертикальной оси. Чтобы указать свойства этого объекта, вы можете использовать буквальную запись объекта, как показано здесь:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Тип: объект
По умолчанию: ноль
vAxis.baseline

Свойство vAxis , определяющее базовую линию вертикальной оси. Если базовая линия больше самой высокой линии сетки или меньше самой нижней линии сетки, она будет округлена до ближайшей линии сетки.

Тип: номер
По умолчанию: автоматический
vAxis.baselineColor

Указывает цвет базовой линии вертикальной оси. Может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' .

Тип: номер
По умолчанию: «черный»
vAxis.direction

Направление роста значений по вертикальной оси. По умолчанию низкие значения находятся внизу диаграммы. Укажите -1 , чтобы изменить порядок значений.

Тип: 1 или -1
По умолчанию: 1
vAxis.format

Строка формата для меток числовых осей. Это подмножество набора шаблонов ICU . Например, {format:'#,###%'} будет отображать значения «1000%», «750%» и «50%» для значений 10, 7,5 и 0,5. Вы также можете предоставить что-либо из следующего:

  • {format: 'none'} : отображает числа без форматирования (например, 8000000).
  • {format: 'decimal'} : отображает числа с разделителями тысяч (например, 8 000 000).
  • {format: 'scientific'} : отображает числа в экспоненциальном формате (например, 8e6).
  • {format: 'currency'} : отображает числа в местной валюте (например, 8 000 000,00 долларов США).
  • {format: 'percent'} : отображает числа в процентах (например, 800 000 000%).
  • {format: 'short'} : отображает сокращенные номера (например, 8M)
  • {format: 'long'} : отображает числа как полные слова (например, 8 миллионов).

Фактическое форматирование, примененное к метке, определяется языковым стандартом, с которым был загружен API. Дополнительные сведения см. в разделе Загрузка диаграмм с определенной локалью .

При вычислении значений делений и линий сетки будут рассматриваться несколько альтернативных комбинаций всех соответствующих вариантов линий сетки, и альтернативы будут отклонены, если отформатированные метки делений будут дублироваться или перекрываться. Таким образом, вы можете указать format:"#" если хотите отображать только целочисленные значения делений, но имейте в виду, что если ни одна альтернатива не удовлетворяет этому условию, ни линии сетки, ни деления отображаться не будут.

Тип: строка
По умолчанию: авто
vAxis.gridlines

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

{color: '#333', minSpacing: 20}
Тип: объект
По умолчанию: ноль
vAxis.gridlines.color

Цвет вертикальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку HTML.

Тип: строка
По умолчанию: '#CCC'
vAxis.gridlines.count

Примерное количество горизонтальных линий сетки внутри области диаграммы. Если вы укажете положительное число для gridlines.count , оно будет использоваться для вычисления minSpacing между линиями сетки. Вы можете указать значение 1 , чтобы рисовать только одну линию сетки, или 0 , чтобы линии сетки не отображались. Укажите -1 (значение по умолчанию), чтобы автоматически вычислить количество линий сетки на основе других параметров.

Тип: номер
По умолчанию: -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 , которое преобразует вертикальную ось в логарифмический масштаб. Может быть одним из следующих:

  • null — логарифмическое масштабирование не выполняется.
  • 'log' - логарифмическое масштабирование. Отрицательные и нулевые значения не отображаются. Этот параметр аналогичен настройке vAxis: { logscale: true } .
  • 'mirrorLog' — логарифмическое масштабирование, при котором отображаются отрицательные и нулевые значения. Нанесенное на график значение отрицательного числа является отрицательным логарифмом абсолютного значения. Значения, близкие к 0, отображаются в линейном масштабе.
Тип: строка
По умолчанию: ноль
vAxis.textPosition

Положение текста вертикальной оси относительно области диаграммы. Поддерживаемые значения: «вне», «вход», «нет».

Тип: строка
По умолчанию: «выход»
vAxis.textStyle

Объект, задающий стиль текста по вертикальной оси. Объект имеет такой формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.ticks

Заменяет автоматически сгенерированные отметки оси Y указанным массивом. Каждый элемент массива должен быть либо допустимым значением тика (например, числом, датой, датой и временем или днем), либо объектом. Если это объект, он должен иметь свойство v для значения отметки и необязательное свойство f , содержащее литеральную строку, которая будет отображаться в качестве метки.

ViewWindow будет автоматически расширен, чтобы включить отметки min и max, если вы не укажете viewWindow.min или viewWindow.max для переопределения.

Примеры:

  • vAxis: { ticks: [5,10,15,20] }
  • vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
  • vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
  • vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }
Тип: Массив элементов
По умолчанию: авто
vAxis.title

Свойство vAxis , указывающее заголовок вертикальной оси.

Тип: строка
По умолчанию: без названия
vAxis.titleTextStyle

Объект, определяющий стиль текста заголовка вертикальной оси. Объект имеет такой формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

color может быть любой цветовой строкой HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.maxValue

Перемещает максимальное значение вертикальной оси на указанное значение; на большинстве графиков это будет вверх. Игнорируется, если для этого параметра установлено значение меньше максимального значения y данных. vAxis.viewWindow.max переопределяет это свойство.

Тип: номер
По умолчанию: автоматический
vAxis.minValue

Перемещает минимальное значение вертикальной оси на указанное значение; на большинстве графиков это будет снижение. Игнорируется, если это установлено значение, превышающему минимальное значение y данных. vAxis.viewWindow.min переопределяет это свойство.

Тип: номер
По умолчанию: NULL
vaxis.viewwindowmode

Указывает, как масштабировать вертикальную ось, чтобы отобразить значения в области диаграммы. Поддерживаются следующие строковые значения:

  • «Довольно» - масштабируйте вертикальные значения так, чтобы максимальные и минимальные значения данных были сделаны немного в нижней и верхней части области диаграммы. ViewWindow расширяется до ближайшей основной линии сетки для чисел или ближайшей незначительной линии сетки для дат и времени.
  • «Максимизированный» - масштабируйте вертикальные значения так, чтобы максимальные и минимальные значения данных касались верхней и нижней части области диаграммы. Это приведет к тому, что vaxis.viewWindow.min и vaxis.viewWindow.max будет игнорироваться.
  • «Явный» - устаревший вариант для определения значений верхней и нижней шкалы площади диаграммы. (Установилось, потому что он избыточно с vaxis.viewWindow.min и vaxis.viewWindow.max . Значения данных за пределами этих значений будут обрезаны. Вы должны указать объект vAxis.viewWindow , описывающий максимальные и минимальные значения, чтобы показать.
Тип: строка
По умолчанию: эквивалент «красиво», но vaxis.viewWindow.min и vaxis.viewWindow.max имеет приоритет при использовании.
vaxis.viewwindow

Указывает диапазон обрезки вертикальной оси.

Тип: объект
По умолчанию: NULL
vaxis.viewwindow.max

Максимальное значение вертикального данных для рендеринга.

Игнорируется, когда vAxis.viewWindowMode «симпатичный» или «максимизирован».

Тип: номер
По умолчанию: Auto
vaxis.viewwindow.min

Минимальное значение вертикального данных для рендеринга.

Игнорируется, когда vAxis.viewWindowMode «симпатичный» или «максимизирован».

Тип: номер
По умолчанию: Auto
ширина

Ширина диаграммы, в пикселях.

Тип: номер
По умолчанию: ширина содержащего элемента

Методы

Метод
draw(data, options)

Рисует диаграмму. Диаграмма принимает дальнейшие вызовы метода только после того, как ready событие будет запущено. Extended description .

Возвращение типа: нет
getAction(actionID)

Возвращает объект действий подсказки инструментов с запрошенным actionID .

Возвращение типа: объект
getBoundingBox(id)

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

var cli = chart.getChartLayoutInterface();

Высота зоны графика
cli.getBoundingBox('chartarea').height
Ширина третьего бара в первой серии диаграммы бара или колонны
cli.getBoundingBox('bar#0#2').width
Ограничивающая коробка пятого клина круговой диаграммы
cli.getBoundingBox('slice#4')
Ограничивающая коробка данных диаграммы вертикальной (например, столбца) диаграммы:
cli.getBoundingBox('vAxis#0#gridline')
Ограничивающая коробка данных диаграммы горизонтальной (например, бар):
cli.getBoundingBox('hAxis#0#gridline')

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

Возвращение типа: объект
getChartAreaBoundingBox()

Возвращает объект, содержащий левую, верхнюю, ширину и высоту содержания диаграммы (то есть, исключая этикетки и легенду):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left
cli.getChartAreaBoundingBox().top
cli.getChartAreaBoundingBox().height
cli.getChartAreaBoundingBox().width

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

Возвращение типа: объект
getChartLayoutInterface()

Возвращает объект, содержащий информацию о экране размещения диаграммы и его элементов.

Следующие методы можно вызвать на возвращаемый объект:

  • getBoundingBox
  • getChartAreaBoundingBox
  • getHAxisValue
  • getVAxisValue
  • getXLocation
  • getYLocation

Назовите это после того, как график будет нарисована.

Возвращение типа: объект
getHAxisValue(xPosition, optional_axis_index)

Возвращает горизонтальное значение данных при xPosition , которое представляет собой смещение пикселя из левого края контейнера диаграммы. Может быть отрицательным.

Пример: chart.getChartLayoutInterface().getHAxisValue(400) .

Назовите это после того, как график будет нарисована.

Возврат тип: номер
getImageURI()

Возвращает диаграмму, сериализованную как изображение URI.

Назовите это после того, как график будет нарисована.

Смотрите печатные диаграммы PNG .

Возвращение типа: строка
getSelection()

Возвращает массив выбранных диаграмм. Выбираемые объекты - пузырьки. Для этой диаграммы можно выбрать только один объект в любой момент. Extended description .

Тип возврата: массив элементов выбора
getVAxisValue(yPosition, optional_axis_index)

Возвращает вертикальное значение данных при yPosition , которое представляет собой смещение пикселя вниз по верхней краю контейнера диаграммы. Может быть отрицательным.

Пример: chart.getChartLayoutInterface().getVAxisValue(300) .

Назовите это после того, как график будет нарисована.

Возврат тип: номер
getXLocation(dataValue, optional_axis_index)

Возвращает Pixel X-координату dataValue по сравнению с левым краем контейнера диаграммы.

Пример: chart.getChartLayoutInterface().getXLocation(400) .

Назовите это после того, как график будет нарисована.

Возврат тип: номер
getYLocation(dataValue, optional_axis_index)

Возвращает Pixel Y-координату dataValue по сравнению с верхним краем контейнера диаграммы.

Пример: chart.getChartLayoutInterface().getYLocation(300) .

Назовите это после того, как график будет нарисована.

Возврат тип: номер
removeAction(actionID)

Удаляет действие подсказки инструментов с помощью запрошенного actionID из диаграммы.

Возвращение типа: none
setAction(action)

Устанавливает действие подсказки инструментов для выполнения, когда пользователь нажимает на текст действия.

Метод setAction принимает объект в качестве параметра действия. Этот объект должен указать 3 свойства: id - идентификатор установленного действия, text - текст, который должен отображаться в всплеске инструментов для действия, и action - функцию, которую следует запускать, когда пользователь нажимает на текст действия.

Любые действия по всплеске инструментов должны быть установлены до вызова метода draw() . Расширенное описание .

Возвращение типа: none
setSelection()

Выбирает указанные диаграммы. Отменяет любой предыдущий выбор. Выбираемые объекты - пузырьки. Для этой диаграммы можно выбрать только один объект. Extended description .

Возвращение типа: нет
clearChart()

Очищает диаграмму и выпускает все его выделенные ресурсы.

Возвращение типа: нет

События

Для получения дополнительной информации о том, как использовать эти события, см. Базовую интерактивность , обработку событий и стрельбы .

Имя
animationfinish

Уволен, когда переходная анимация завершена.

Свойства: нет
click

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

Свойства: TargetId
error

Уволен, когда возникает ошибка при попытке отобрать диаграмму.

Свойства: ID, сообщение
legendpagination

Запускается, когда пользователь нажимает стрелки Legend Pagination. Обращает обратно текущий индекс страниц на основе Legend Zero и общее количество страниц.

Свойства: CurrentPageIndex, TotalPages
onmouseover

Уволен, когда пользователь объединяет визуальную сущность. Передает индексы строки и столбца соответствующего элемента таблицы данных. Пузырь коррелирует со строкой в ​​таблице данных (индекс столбца нулевой).

Свойства: ряд, столбец
onmouseout

Выстрелил, когда пользователь уходит от визуальной сущности. Передает индексы строки и столбца соответствующего элемента таблицы данных. Пузырь коррелирует со строкой в ​​таблице данных (индекс столбца нулевой).

Свойства: ряд, столбец
ready

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

Свойства: нет
select

Уволен, когда пользователь нажимает на визуальную сущность. Чтобы узнать, что было выбрано, позвоните getSelection() .

Свойства: нет

Политика данных

Все код и данные обрабатываются и отображаются в браузере. Никакие данные не отправляются ни на один сервер.