Свечные графики

• 'category' : Сгруппировать выбранные данные по x-значению.
• 'series' : группировать выбранные данные по сериям.
• 'auto' : группировать выбранные данные по значению x, если все выборки имеют одинаковое значение x, и по сериям в противном случае.
• 'none' : показывать только одну всплывающую подсказку для каждого выбора.

var options = {
  // Allow multiple
  // simultaneous selections.
  selectionMode: 'multiple',
  // Trigger tooltips
  // on selections.
  tooltip: {trigger: 'selection'},
  // Group selections
  // by x-value.
  aggregationTarget: 'category',
};
    

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

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

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

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

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

• in — рисовать заголовки осей внутри области диаграммы.
• out — Нарисуйте заголовки осей за пределами области диаграммы.
• none — не указывать заголовки осей.

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

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

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

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

• Пиксели (например, 50).
• Процент доступной ширины для каждой группы (например, «20%»), где «100%» означает, что между группами нет пробелов.

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

Цвет заливки падающих свечей в виде строки цвета HTML.

Цвет обводки падающих свечей в виде строки цвета HTML.

Ширина штриха падающих свечей в виде строки цвета HTML.

Цвет заливки восходящих свечей в виде строки цвета HTML.

Цвет обводки восходящих свечей в виде строки цвета HTML.

Ширина штриха восходящих свечей в виде строки цвета HTML.

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

• stroke : цвет, представленный в виде шестнадцатеричной строки или имени цвета на английском языке.
• strokeWidth : если указано, рисует границу вокруг области диаграммы заданной ширины (и с цветом stroke ).

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

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

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

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

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

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

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

• 'datum' — сосредоточиться на одной точке данных. Соответствует ячейке в таблице данных.
• «Категория» — сосредоточьтесь на группировке всех точек данных вдоль главной оси. Соответствует строке в таблице данных.

В focusTarget 'category' всплывающая подсказка отображает все значения категории. Это может быть полезно для сравнения значений разных рядов.

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

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

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

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    

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

Этот параметр поддерживается только для continuous оси.

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

Этот параметр поддерживается только для continuous оси.

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

Строка формата для числовых меток или меток оси дат.

Для меток числовой оси это подмножество набора шаблонов десятичного форматирования 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 миллионов)

Для меток оси дат это подмножество набора шаблонов форматирования даты ICU . Например, {format:'MMM d, y'} будет отображать значение "1 июля 2011 года" для даты первого июля 2011 года.

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

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

Этот параметр поддерживается только для continuous оси.

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

{color: '#333', minSpacing: 20}

Этот параметр поддерживается только для continuous оси.

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

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

Массив размеров (в виде значений данных, а не пикселей) между соседними линиями сетки. В настоящее время этот параметр предназначен только для числовых осей, но он аналогичен параметрам gridlines.units.<unit>.interval , которые используются только для дат и времени. Для линейных масштабов значение по умолчанию — [1, 2, 2.5, 5] что означает, что значения линии сетки могут падать на каждую единицу (1), на четные единицы (2) или на кратные 2,5 или 5. Любая степень 10 раз эти значения также учитываются (например, [10, 20, 25, 50] и [.1, .2, .25, .5]). Для логарифмических масштабов значение по умолчанию — [1, 2, 5] .

Минимальное пространство экрана в пикселях между основными линиями сетки hAxis. Значение по умолчанию для основных линий сетки равно 40 для линейных масштабов и 20 для логарифмических масштабов. Если вы укажете count , а не minSpacing , minSpacing вычисляется из счетчика. И наоборот, если вы укажете minSpacing а не count , счетчик будет вычисляться из minSpacing. Если вы укажете оба, minSpacing переопределяет.

Все значения линий сетки и делений должны быть кратны значению этого параметра. Обратите внимание, что, в отличие от интервалов, степени, умноженные на 10, не учитываются. Таким образом, вы можете заставить тики быть целыми числами, указав gridlines.multiple = 1 , или заставить тики быть кратными 1000, указав gridlines.multiple = 1000 .

Переопределяет формат по умолчанию для различных аспектов типов данных даты/даты/времени/времени дня при использовании с вычисляемыми линиями сетки диаграммы. Позволяет форматировать годы, месяцы, дни, часы, минуты, секунды и миллисекунды.

Общий формат:

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.gridlines.

Этот параметр поддерживается только для continuous оси.

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

Параметр minorGridlines.interval аналогичен параметру интервала основных линий сетки, но выбранный интервал всегда будет четным делителем интервала основных линий сетки. Интервал по умолчанию для линейных масштабов — [1, 1.5, 2, 2.5, 5] , а для логарифмических масштабов — [1, 2, 5] .

Минимальное необходимое пространство в пикселях между соседними второстепенными линиями сетки и между второстепенными и основными линиями сетки. Значение по умолчанию — 1/2 minSpacing основных линий сетки для линейных масштабов и 1/5 minSpacing для логарифмических масштабов.

То же, что и для основных gridlines.multiple .

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

Переопределяет формат по умолчанию для различных аспектов типов данных date/datetime/timeofday при использовании с вычисляемыми диаграммами MinorGridlines. Позволяет форматировать годы, месяцы, дни, часы, минуты, секунды и миллисекунды.

Общий формат:

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

Этот параметр поддерживается только для continuous оси.

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

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

Этот параметр поддерживается только для continuous оси.

Положение текста по горизонтальной оси относительно области диаграммы. Поддерживаемые значения: 'out', 'in', 'none'.

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

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

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

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

ViewWindow будет автоматически расширен, чтобы включить минимальные и максимальные отметки, если вы не укажете 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] }

Этот параметр поддерживается только для continuous оси.

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

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

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

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

Если задано значение false, крайние метки будут скрыты, а не будут обрезаны контейнером диаграммы. Если true, будет разрешена обрезка метки.

Этот параметр поддерживается только для discrete оси.

Если установлено значение true, нарисуйте текст по горизонтальной оси под углом, чтобы разместить больше текста вдоль оси; если false, нарисуйте текст по горизонтальной оси вертикально. Поведение по умолчанию — наклон текста, если он не может полностью уместиться при вертикальном рисовании. Обратите внимание, что этот параметр доступен только в том случае, если для hAxis.textPosition установлено значение «out» (по умолчанию). Значение по умолчанию false для дат и времени.

Угол текста по горизонтальной оси, если он нарисован под наклоном. Игнорируется, если hAxis.slantedText имеет значение false или находится в автоматическом режиме, а диаграмма решила отобразить текст горизонтально. Если угол положительный, то вращение происходит против часовой стрелки, а если отрицательный, то по часовой стрелке.

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

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

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

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

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

Этот параметр поддерживается только для continuous оси.

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

Этот параметр поддерживается только для continuous оси.

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

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

Этот параметр поддерживается только для continuous оси.

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

• Для continuous оси:

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

• Для discrete оси:

  Отсчитываемый от нуля индекс строки, где заканчивается окно обрезки. Точки данных с этим индексом и выше будут обрезаны. В сочетании с vAxis.viewWindowMode.min он определяет полуоткрытый диапазон [min, max), обозначающий отображаемые индексы элементов. Другими словами, будет отображаться каждый такой индекс, что min <= index < max .

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

• Для continuous оси:

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

• Для discrete оси:

  Отсчитываемый от нуля индекс строки, с которой начинается окно обрезки. Точки данных с индексами ниже этого будут обрезаны. В сочетании с vAxis.viewWindowMode.max он определяет полуоткрытый диапазон [min, max), обозначающий отображаемые индексы элементов. Другими словами, будет отображаться каждый такой индекс, что min <= index < max .

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

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

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}

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

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

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

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

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

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

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

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

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

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

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

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

Ориентация диаграммы. При значении 'vertical' оси диаграммы поворачиваются так, что (например) столбчатая диаграмма становится гистограммой, а диаграмма с областями растет вправо, а не вверх:

Если установлено значение true, серия будет отображаться справа налево. По умолчанию рисование слева направо.

Этот параметр поддерживается только для discrete major оси.

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

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

• color — цвет, используемый для этой серии. Укажите допустимую строку цвета HTML.
• fallingColor.fill — переопределяет глобальное значение candlestick.fallingColor.fill для этой серии.
• fallingColor.stroke — переопределяет глобальное значение candlestick.fallingColor.stroke для этой серии.
• fallingColor.strokeWidth — переопределяет глобальное значение candlestick.fallingColor.strokeWidth для этой серии.
• labelInLegend — описание ряда, отображаемое в легенде диаграммы.
• risingColor.fill — переопределяет глобальное значение candlestick.risingColor.fill для этой серии.
• risingColor.stroke — переопределяет глобальное значение candlestick.risingColor.stroke для этой серии.
• risingColor.strokeWidth — переопределяет глобальное значение candlestick.risingColor.strokeWidth для этой серии.
• targetAxisIndex — какую ось назначить этой серии, где 0 — ось по умолчанию, а 1 — противоположная ось. Значение по умолчанию — 0; установите значение 1, чтобы определить диаграмму, на которой разные ряды отображаются по разным осям. По крайней мере, одна серия должна быть отнесена к оси по умолчанию. Вы можете определить разные масштабы для разных осей.
• visibleInLegend — логическое значение, где true означает, что серия должна иметь легенду, а false означает, что ее не должно быть. Значение по умолчанию верно.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    

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

• «максимизированный» — максимизирует область диаграммы и рисует легенду и все метки внутри области диаграммы. Устанавливает следующие параметры:

  chartArea: {width: '100%', height: '100%'},
  legend: {position: 'in'},
  titlePosition: 'in', axisTitlesPosition: 'in',
  hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
          

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

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

• in — Нарисуйте заголовок внутри области диаграммы.
• out — вывести заголовок за пределы области диаграммы.
• none - пропустить заголовок.

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

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

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

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

{textStyle: {color: '#FF0000'}, showColorCode: true}

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

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

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

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

Если это правда, показывать цветные квадраты рядом с информацией о серии во всплывающей подсказке. Значение по умолчанию — true, если focusTarget установлено значение «категория», в противном случае значение по умолчанию — false.

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

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

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

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

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

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

Чтобы задать диаграмму с несколькими вертикальными осями, сначала определите новую ось с помощью series.targetAxisIndex , а затем настройте ось с помощью vAxes . В следующем примере серия 2 назначается правой оси и задает для нее пользовательский заголовок и стиль текста:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

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

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}

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

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

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

Строка формата для меток числовых осей. Это подмножество набора шаблонов 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:"#" , если вы хотите отображать только целые значения делений, но имейте в виду, что если никакая альтернатива не удовлетворяет этому условию, линии сетки или деления отображаться не будут.

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

{color: '#333', minSpacing: 20}

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1, which is the default, to automatically compute the number of gridlines based on other options.

An array of sizes (as data values, not pixels) between adjacent gridlines. This option is only for numeric axes at this time, but it is analogous to the gridlines.units.<unit>.interval options which are used only for dates and times. For linear scales, the default is [1, 2, 2.5, 5] which means the gridline values can fall on every unit (1), on even units (2), or on multiples of 2.5 or 5. Any power of 10 times these values is also considered (eg [10, 20, 25, 50] and [.1, .2, .25, .5]). For log scales, the default is [1, 2, 5] .

The minimum screen space, in pixels, between hAxis major gridlines. The default for major gridlines is 40 for linear scales, and 20 for log scales. If you specify the count and not the minSpacing , the minSpacing is computed from the count. And conversely, if you specify the minSpacing and not the count , the count is computed from the minSpacing. If you specify both, the minSpacing overrides.

All gridline and tick values must be a multiple of this option's value. Note that, unlike for intervals, powers of 10 times the multiple are not considered. So you can force ticks to be integers by specifying gridlines.multiple = 1 , or force ticks to be multiples of 1000 by specifying gridlines.multiple = 1000 .

Overrides the default format for various aspects of date/datetime/timeofday data types when used with chart computed gridlines. Allows formatting for years, months, days, hours, minutes, seconds, and milliseconds.

General format is:

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*/]}
  }
}
    

Additional information can be found in Dates and Times .

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines depends on the interval between major gridlines (see vAxis.gridlines.interval) and the minimum required space (see vAxis.minorGridlines.minSpacing).

The minorGridlines.interval option is like the major gridlines interval option, but the interval that is chosen will always be an even divisor of the major gridline interval. The default interval for linear scales is [1, 1.5, 2, 2.5, 5] , and for log scales is [1, 2, 5] .

The minimum required space, in pixels, between adjacent minor gridlines, and between minor and major gridlines. The default value is 1/2 the minSpacing of major gridlines for linear scales, and 1/5 the minSpacing for log scales.

Same as for major gridlines.multiple .

Overrides the default format for various aspects of date/datetime/timeofday data types when used with chart computed minorGridlines. Allows formatting for years, months, days, hours, minutes, seconds, and milliseconds.

General format is:

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*/]},
  }
}
    

Additional information can be found in Dates and Times .

If true, makes the vertical axis a logarithmic scale. Note: All values must be positive.

vAxis property that makes the vertical axis a logarithmic scale. Can be one of the following:

• null - No logarithmic scaling is performed.
• 'log' - Logarithmic scaling. Negative and zero values are not plotted. This option is the same as setting vAxis: { logscale: true } .
• 'mirrorLog' - Logarithmic scaling in which negative and zero values are plotted. The plotted value of a negative number is the negative of the log of the absolute value. Values close to 0 are plotted on a linear scale.

This option is only supported for a continuous axis.

Position of the vertical axis text, relative to the chart area. Supported values: 'out', 'in', 'none'.

An object that specifies the vertical axis text style. The object has this format:

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

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Replaces the automatically generated Y-axis ticks with the specified array. Each element of the array should be either a valid tick value (such as a number, date, datetime, or timeofday), or an object. If it's an object, it should have a v property for the tick value, and an optional f property containing the literal string to be displayed as the label.

The viewWindow will be automatically expanded to include the min and max ticks unless you specify a viewWindow.min or viewWindow.max to override.

Examples:

• 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 property that specifies a title for the vertical axis.

An object that specifies the vertical axis title text style. The object has this format:

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

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Specifies how to scale the vertical axis to render the values within the chart area. The following string values are supported:

• 'pretty' - Scale the vertical values so that the maximum and minimum data values are rendered a bit inside the bottom and top of the chart area. The viewWindow is expanded to the nearest major gridline for numbers, or the nearest minor gridline for dates and times.
• 'maximized' - Scale the vertical values so that the maximum and minimum data values touch the top and bottom of the chart area. This will cause vaxis.viewWindow.min and vaxis.viewWindow.max to be ignored.
• 'explicit' - A deprecated option for specifying the top and bottom scale values of the chart area. (Deprecated because it's redundant with vaxis.viewWindow.min and vaxis.viewWindow.max . Data values outside these values will be cropped. You must specify a vAxis.viewWindow object describing the maximum and minimum values to show.

Specifies the cropping range of the vertical axis.

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

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

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

Returns the tooltip action object with the requested actionID .

Returns an object containing the left, top, width, and height of chart element id . The format for id isn't yet documented (they're the return values of event handlers ), but here are some examples:

var cli = chart.getChartLayoutInterface();

Height of the chart area

cli.getBoundingBox('chartarea').height

Width of the third bar in the first series of a bar or column chart

cli.getBoundingBox('bar#0#2').width

Bounding box of the fifth wedge of a pie chart

cli.getBoundingBox('slice#4')

Bounding box of the chart data of a vertical (eg, column) chart:

cli.getBoundingBox('vAxis#0#gridline')

Bounding box of the chart data of a horizontal (eg, bar) chart:

cli.getBoundingBox('hAxis#0#gridline')

Values are relative to the container of the chart. Call this after the chart is drawn.

Returns an object containing the left, top, width, and height of the chart content (ie, excluding labels and legend):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

Values are relative to the container of the chart. Call this after the chart is drawn.

Returns an object containing information about the onscreen placement of the chart and its elements.

The following methods can be called on the returned object:

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

Call this after the chart is drawn.

Returns the horizontal data value at xPosition , which is a pixel offset from the chart container's left edge. Can be negative.

Example: chart.getChartLayoutInterface().getHAxisValue(400) .

Call this after the chart is drawn.

Returns the chart serialized as an image URI.

Call this after the chart is drawn.

See Printing PNG Charts .

Returns an array of the selected chart entities. Selectable entities are candlesticks, legend entries and categories. For this chart, only one entity can be selected at any given moment. Extended description .

Returns the vertical data value at yPosition , which is a pixel offset down from the chart container's top edge. Can be negative.

Example: chart.getChartLayoutInterface().getVAxisValue(300) .

Call this after the chart is drawn.

Returns the pixel x-coordinate of dataValue relative to the left edge of the chart's container.

Example: chart.getChartLayoutInterface().getXLocation(400) .

Call this after the chart is drawn.

Returns the pixel y-coordinate of dataValue relative to the top edge of the chart's container.

Example: chart.getChartLayoutInterface().getYLocation(300) .

Call this after the chart is drawn.

Removes the tooltip action with the requested actionID from the chart.

Sets a tooltip action to be executed when the user clicks on the action text.

The setAction method takes an object as its action parameter. This object should specify 3 properties: id — the ID of the action being set, text —the text that should appear in the tooltip for the action, and action — the function that should be run when a user clicks on the action text.

Any and all tooltip actions should be set prior to calling the chart's draw() method. Extended description .

Selects the specified chart entities. Cancels any previous selection. Selectable entities are candlesticks, legend entries and categories. For this chart, only one entity can be selected at a time. Extended description .

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

Fired when transition animation is complete.

Fired when the user clicks inside the chart. Can be used to identify when the title, data elements, legend entries, axes, gridlines, or labels are clicked.

Fired when an error occurs when attempting to render the chart.

Fired when the user clicks legend pagination arrows. Passes back the current legend zero-based page index and the total number of pages.

Fired when the user mouses over a visual entity. Passes back the row and column indices of the corresponding data table element. A candlestick correlates to a cell in the data table, a legend entry to a column (row index is null), and a category to a row (column index is null).

Fired when the user mouses away from a visual entity. Passes back the row and column indices of the corresponding data table element. A candlestick correlates to a cell in the data table, a legend entry to a column (row index is null), and a category to a row (column index is null).

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

Fired when the user clicks a visual entity. To learn what has been selected, call getSelection() .