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

Обзор

Круговая диаграмма, отображаемая в браузере с использованием SVG или VML . Отображает всплывающие подсказки при наведении курсора на фрагменты.

Пример

<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="piechart" style="width: 900px; height: 500px;"></div> google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Task', 'Hours per Day'], ['Work', 11], ['Eat', 2], ['Commute', 2], ['Watch TV', 2], ['Sleep', 7] ]); var options = { title: 'My Daily Activities' }; var chart = new google.visualization.PieChart(document.getElementById('piechart')); chart.draw(data, options); } <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="piechart" style="width: 900px; height: 500px;"></div> google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Task', 'Hours per Day'], ['Work', 11], ['Eat', 2], ['Commute', 2], ['Watch TV', 2], ['Sleep', 7] ]); var options = { title: 'My Daily Activities' }; var chart = new google.visualization.PieChart(document.getElementById('piechart')); chart.draw(data, options); }
<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([
          ['Task', 'Hours per Day'],
          ['Work',     11],
          ['Eat',      2],
          ['Commute',  2],
          ['Watch TV', 2],
          ['Sleep',    7]
        ]);

        var options = {
          title: 'My Daily Activities'
        };

        var chart = new google.visualization.PieChart(document.getElementById('piechart'));

        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="piechart" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Создание трехмерной круговой диаграммы

Если вы установите для параметра is3D значение true , ваша круговая диаграмма будет отображаться так, как если бы она имела три измерения:

is3D по умолчанию имеет значение false , поэтому здесь мы явно устанавливаем для него значение true :

<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([
          ['Task', 'Hours per Day'],
          ['Work',     11],
          ['Eat',      2],
          ['Commute',  2],
          ['Watch TV', 2],
          ['Sleep',    7]
        ]);

        var options = {
          title: 'My Daily Activities',
          is3D: true,
        };

        var chart = new google.visualization.PieChart(document.getElementById('piechart_3d'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="piechart_3d" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Создание кольцевой диаграммы

Кольцевая диаграмма представляет собой круговую диаграмму с отверстием в центре. Вы можете создавать кольцевые диаграммы с опцией pieHole :

Для параметра pieHole должно быть установлено число от 0 до 1, соответствующее соотношению радиусов между отверстием и диаграммой. Числа от 0,4 до 0,6 будут лучше всего смотреться на большинстве графиков. Значения, равные или превышающие 1, будут игнорироваться, а значение 0 полностью закроет вашу дырку.

<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([
          ['Task', 'Hours per Day'],
          ['Work',     11],
          ['Eat',      2],
          ['Commute',  2],
          ['Watch TV', 2],
          ['Sleep',    7]
        ]);

        var options = {
          title: 'My Daily Activities',
          pieHole: 0.4,
        };

        var chart = new google.visualization.PieChart(document.getElementById('donutchart'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="donutchart" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Вы не можете комбинировать параметры pieHole и is3D ; если вы это сделаете, pieHole будет проигнорирован.

Обратите внимание, что Google Charts пытается разместить метку как можно ближе к центру среза. Если у вас есть кольцевая диаграмма только с одним фрагментом, центр фрагмента может попасть в отверстие для пончика. В этом случае измените цвет метки:

<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="donut_single" style="width: 900px; height: 500px;"></div> google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Effort', 'Amount given'], ['My all', 100], ]); var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' }; var chart = new google.visualization.PieChart(document.getElementById('donut_single')); chart.draw(data, options); } <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="donut_single" style="width: 900px; height: 500px;"></div> google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Effort', 'Amount given'], ['My all', 100], ]); var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' }; var chart = new google.visualization.PieChart(document.getElementById('donut_single')); chart.draw(data, options); }
Опции
        var options = {
          pieHole: 0.5,
          pieSliceTextStyle: {
            color: 'black',
          },
          legend: 'none'
        };
Полный HTML
<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([
          ['Effort', 'Amount given'],
          ['My all',     100],
        ]);

        var options = {
          pieHole: 0.5,
          pieSliceTextStyle: {
            color: 'black',
          },
          legend: 'none'
        };

        var chart = new google.visualization.PieChart(document.getElementById('donut_single'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="donut_single" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Вращение круговой диаграммы

По умолчанию круговые диаграммы начинаются с левого края первого среза, направленного прямо вверх. Вы можете изменить это с помощью опции pieStartAngle :

Здесь мы поворачиваем диаграмму по часовой стрелке на 100 градусов с параметром pieStartAngle: 100 . (Так выбрано потому, что именно под этим углом этикетка «итальянский» помещается внутри среза.)

<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([
          ['Language', 'Speakers (in millions)'],
          ['German',  5.85],
          ['French',  1.66],
          ['Italian', 0.316],
          ['Romansh', 0.0791]
        ]);

      var options = {
        legend: 'none',
        pieSliceText: 'label',
        title: 'Swiss Language Use (100 degree rotation)',
        pieStartAngle: 100,
      };

        var chart = new google.visualization.PieChart(document.getElementById('piechart'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="piechart" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Взрывание среза

Вы можете отделить сегменты круговой диаграммы от остальной части диаграммы с помощью свойства offset параметра slices :

Чтобы разделить срез, создайте объект slices и назначьте соответствующему номеру слайса offset от 0 до 1. Ниже мы назначаем постепенно увеличивающиеся смещения слайсам 4 (гуджарати), 12 (маратхи), 14 (ория) и 15 (панджаби). ):

<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([
          ['Language', 'Speakers (in millions)'],
          ['Assamese', 13], ['Bengali', 83], ['Bodo', 1.4],
          ['Dogri', 2.3], ['Gujarati', 46], ['Hindi', 300],
          ['Kannada', 38], ['Kashmiri', 5.5], ['Konkani', 5],
          ['Maithili', 20], ['Malayalam', 33], ['Manipuri', 1.5],
          ['Marathi', 72], ['Nepali', 2.9], ['Oriya', 33],
          ['Punjabi', 29], ['Sanskrit', 0.01], ['Santhali', 6.5],
          ['Sindhi', 2.5], ['Tamil', 61], ['Telugu', 74], ['Urdu', 52]
        ]);

        var options = {
          title: 'Indian Language Use',
          legend: 'none',
          pieSliceText: 'label',
          slices: {  4: {offset: 0.2},
                    12: {offset: 0.3},
                    14: {offset: 0.4},
                    15: {offset: 0.5},
          },
        };

        var chart = new google.visualization.PieChart(document.getElementById('piechart'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="piechart" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Удаление фрагментов

Чтобы опустить фрагмент, измените цвет на 'transparent' :

Мы также использовали pieStartAngle для поворота диаграммы на 135 градусов, pieSliceText для удаления текста из срезов и tooltip.trigger для отключения всплывающих подсказок:

<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([
          ['Pac Man', 'Percentage'],
          ['', 75],
          ['', 25]
        ]);

        var options = {
          legend: 'none',
          pieSliceText: 'none',
          pieStartAngle: 135,
          tooltip: { trigger: 'none' },
          slices: {
            0: { color: 'yellow' },
            1: { color: 'transparent' }
          }
        };

        var chart = new google.visualization.PieChart(document.getElementById('pacman'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="pacman" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Порог видимости среза

Вы можете установить значение в качестве порога для индивидуального рендеринга сегмента круговой диаграммы. Это значение соответствует части диаграммы (при этом вся диаграмма имеет значение 1). Чтобы установить этот порог в процентах от целого, разделите желаемый процент на 100 (для порога 20% значение будет равно 0,2).

sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.

Любые слайсы меньше этого порога будут объединены в один слайс «Другие» и будут иметь объединенное значение всех слайсов ниже порога.

    google.charts.load('current', {'packages':['corechart']});
    google.charts.setOnLoadCallback(drawChart);

    function drawChart() {

      var data = new google.visualization.DataTable();
      data.addColumn('string', 'Pizza');
      data.addColumn('number', 'Populartiy');
      data.addRows([
        ['Pepperoni', 33],
        ['Hawaiian', 26],
        ['Mushroom', 22],
        ['Sausage', 10], // Below limit.
        ['Anchovies', 9] // Below limit.
      ]);

      var options = {
        title: 'Popularity of Types of Pizza',
        sliceVisibilityThreshold: .2
      };

      var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
      chart.draw(data, options);
    }

Загрузка

Имя пакета google.charts.load"corechart" .

  google.charts.load("current", {packages: ["corechart"]});

Имя класса визуализации — google.visualization.PieChart .

  var visualization = new google.visualization.PieChart(container);

Формат данных

Строки: Каждая строка в таблице представляет собой срез.

Столбцы:

Столбец 0 Колонка 1 ... Столбец N (необязательно)
Цель: Метки срезов Значения среза ... Дополнительные роли
Тип данных: нить количество ...
Роль: домен данные ...
Необязательные роли столбцов : Никто Никто ...

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

Имя
фоновый цвет

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

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

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

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

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

Тип: номер
По умолчанию: 0
backgroundColor.fill

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

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

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

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

Как далеко рисовать график от левой границы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Тип: строка
По умолчанию: «Arial».
ForceIFrame

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

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

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

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

Если true, отображает трехмерную диаграмму.

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

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

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

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

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

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

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

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

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

  • 'bottom' — отображает легенду под диаграммой.
  • 'labeled' — рисует линии, соединяющие срезы с их значениями данных.
  • 'left' — отображает легенду слева от диаграммы.
  • 'none' - легенда не отображается.
  • 'right' — легенда отображается справа от диаграммы.
  • 'top' — отображает легенду над диаграммой.
Тип: строка
По умолчанию: «право»
легенда.maxLines

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

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

Тип: номер
По умолчанию: 1
легенда.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>}
отверстие для пирога

Если между 0 и 1, отображает кольцевую диаграмму. Отверстие с радиусом, равным number , умноженному на радиус диаграммы.

Тип: номер
По умолчанию: 0
пирогСрезГраницыЦвет

Цвет границ среза. Применимо, только если диаграмма двумерная.

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

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

  • 'percentage' - Процент размера среза от общего количества.
  • 'value' - Количественное значение среза.
  • 'метка' - имя слайса.
  • 'none' - текст не отображается.
Тип: строка
По умолчанию: «процент»
pieSliceTextStyle

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

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

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

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

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

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

Если true, рисует срезы против часовой стрелки. По умолчанию рисование по часовой стрелке.

Тип: логический
По умолчанию: ложь
пирогОстатокСрезЦвет

Цвет комбинированного среза, который содержит все срезы ниже sliceVisibilityThreshold.

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

Метка для комбинированного среза, содержащего все слайсы ниже sliceVisibilityThreshold .

Тип: строка
По умолчанию: «Другое»
ломтики

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

  • color — цвет, который будет использоваться для этого фрагмента. Укажите допустимую строку цвета HTML.
  • offset - насколько далеко отделить срез от остальной части круга, от 0,0 (совсем нет) до 1,0 (радиус круга).
  • textStyle — переопределяет глобальный pieSliceTextStyle для этого фрагмента.

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

slices: [{color: 'black'}, {}, {}, {color: 'red'}]
slices: {0: {color: 'black'}, 3: {color: 'red'}}
      
Тип: массив объектов или объект с вложенными объектами.
По умолчанию: {}
sliceVisibilityThreshold

Дробное значение круговой диаграммы, ниже которого срез не будет отображаться по отдельности. Все слайсы, не превысившие этот порог, будут объединены в один слайс «Другое», размер которого равен сумме всех их размеров. По умолчанию ни один срез меньше половины градуса не отображается отдельно.

// Slices less than 25% of the pie will be
// combined into an "Other" slice.
sliceVisibilityThreshold: .25
      
Тип: номер
По умолчанию: полградуса (0,5/360, 1/720 или 0,0014).
заглавие

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

Тип: строка
По умолчанию: без названия
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>}
подсказка

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

{textStyle: {color: '#FF0000'}, showColorCode: true}
Тип: объект
По умолчанию: ноль
tooltip.ignoreBounds

Если установлено значение true , разрешает рисование всплывающих подсказок за пределами диаграммы со всех сторон.

Примечание. Это относится только к всплывающим подсказкам в формате HTML. Если это включено с помощью всплывающих подсказок SVG, любое переполнение за пределами границ диаграммы будет обрезано. Дополнительные сведения см. в разделе Настройка содержимого всплывающей подсказки .

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

Если установлено значение true, используйте всплывающие подсказки в формате HTML (а не в формате SVG). Дополнительные сведения см. в разделе Настройка содержимого всплывающей подсказки .

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

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

Если true, отображать цветные квадраты рядом с информацией о срезе во всплывающей подсказке.

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

Какую информацию отображать, когда пользователь наводит курсор на кусок пирога. Поддерживаются следующие значения:

  • 'both' — [по умолчанию ] Отображение как абсолютного значения среза, так и процента от целого.
  • 'value' — отображать только абсолютное значение среза.
  • 'percentage' — отображать только процентную долю от целого, представленного срезом.
Тип: строка
По умолчанию: «оба»
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>}
всплывающая подсказка.триггер

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

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

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

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

Методы

Метод
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)

Возвращает x-координату dataValue относительно левого края контейнера диаграммы.

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

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

Тип возврата: число
getYLocation(dataValue, optional_axis_index)

Возвращает y-координату dataValue относительно верхнего края контейнера диаграммы.

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

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

Тип возврата: число
removeAction(actionID)

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

Тип возврата: none
setAction(action)

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

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

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

Тип возврата: none
setSelection()

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

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

Очищает диаграмму и освобождает все выделенные ей ресурсы.

Тип возврата: нет

События

Дополнительные сведения о том, как использовать эти события, см. в разделах Базовая интерактивность , Обработка событий и Активация событий .

Имя
click

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

Свойства: targetID
error

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

Свойства: идентификатор, сообщение
onmouseover

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

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

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

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

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

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

Запускается, когда пользователь щелкает визуальный объект. Чтобы узнать, что было выбрано, вызовите getSelection() .

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

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

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