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

• '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' - Успокойтесь - Начинайте быстро и замедляйтесь.
• «inAndOut» — легкость входа и выхода — начинайте медленно, ускоряйтесь, затем замедляйтесь.

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

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

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

Цвет фона основной области диаграммы. Это может быть либо простая цветовая строка 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 «категория» всплывающая подсказка отображает все значения категории. Это может быть полезно для сравнения значений разных рядов.

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

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

Рисует диаграмму внутри встроенного фрейма. (Обратите внимание, что в 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 .

Переопределяет формат по умолчанию для различных аспектов типов данных 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.gridlines.

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

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

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

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

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

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

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

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

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

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

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

Заменяет автоматически сгенерированные отметки оси 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] }

Эта опция поддерживается только для 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 оси.

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

• «красиво» — масштабируйте горизонтальные значения так, чтобы максимальные и минимальные значения данных отображались немного внутри левой и правой части области диаграммы. Окно просмотра расширяется до ближайшей основной линии сетки для чисел или ближайшей второстепенной линии сетки для дат и времени.
• «максимизировано» — масштабируйте горизонтальные значения так, чтобы максимальные и минимальные значения данных касались левой и правой части области диаграммы. Это приведет к игнорированию haxis.viewWindow.min и haxis.viewWindow.max .
• «явный» — устаревший параметр для указания значений левого и правого масштаба области диаграммы. (Устарело, поскольку оно избыточно для 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' — центрируется в области, отведенной для легенды.
• «конец» — выравнивается по концу области, выделенной для легенды.

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

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

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

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

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

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

• «дно» — под графиком.
• «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 — вывести заголовок за пределы области диаграммы.
• нет – опустите заголовок.

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

{ 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 установлено значение «category», в противном случае значение по умолчанию — false.

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

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

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

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

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

Указывает свойства для отдельных вертикальных осей, если диаграмма имеет несколько вертикальных осей. Каждый дочерний объект является объектом 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}

Цвет вертикальных линий сетки внутри области диаграммы. Укажите допустимую цветовую строку 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 .

Переопределяет формат по умолчанию для различных аспектов типов данных 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.gridlines.

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

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

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

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

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

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

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

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

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

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

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

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

Заменяет автоматически сгенерированные отметки оси 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 , указывающее заголовок вертикальной оси.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает объект, содержащий 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')

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

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

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

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

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

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

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

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

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

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

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

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

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

См. Печать диаграмм PNG .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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