Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

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

Например:

...

С помощью форматирования можно получить виджеты удовлетворяющие особым визуальным аспектам.

Информация

По умолчанию Highcharts рисует в SVG. 
Для переключение на HTML добавляем в начало кода виджета
w.plotOptions.series.dataLabels.useHTML = true
Что дает нам использовать в коде стандартные стили, например:
 Image Removed

...

1. Тернарные операторы

...

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

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

Виджет Текст:

Image Added

Виджет График:

Image Added

Для форматирования используются различные команды. Поддерживается синтаксис языков HTML, JavaScript, а также используются зарезервированные команды:

Раскрыть
titleПримеры использования
  • Математические операции:

    • @value * 1000

    • (@value +100)/100

    • и т.д.

  • Логические операции:

    • @row[0] - @row[1] > 100 ? 'blue':'red'

    • @level == 0 ? @value + ' год' : @level==1? 'месяц ' + @value : ''

    • @value == 'Стоимость реализации товара' ? @value + " руб." : ""

    • @columnPath == "Январь" ? '#03a9e3' : ""

    • и т.д.

  • Дополнение текста:

    • @value + " руб."

    • @value == "Ж" ? @value = "Женщины": @value == "М" ? @value = "Мужчины": @value

    • и т.д.

  • Форматирование стиля текста:

    • '<div style="color: red">' + @value + '</div>'

    • '<div style="color:' + @point.color + '"> '+

...

    • @series.name+ '</div'

...

    • и т.д.

  • Зарезервированные

...

  • функции, набор которых определен для каждого виджета:

...

...

...

...

...

...

“Круговая диаграмма“;

...

“Таблица“;

...

“Сводная таблица“;

...

"Плоская таблица";

...

“Текст“;

...

“Фильтр“.

...

4. Стандартные функции js

Информация

Дополнительно примеры использования см. в разделе “Примеры использования“.

...

Для задания цвета в форматерах существует несколько способов:

...

HTML имя цвета

  • Image Removed

...

rgba

  • Image Removed

HEX

...

  • Стандартные функции JavaScript

Примечание

Перед форматированием свойств виджета необходимо привязать его к данным, например, к базе данных ViQube.

Примеры

Пример 1

Виджет Круговая диаграмма. Вывод итоговой суммы значений в центр круга с помощью зарезервированной команды @total:

Image Added

Пример 2

Виджет Гистограмма. Форматирование подписей столбцов с помощью следующей команды:
'<div style="color:' + @point.color + '"> '+ @series.name+ '</div>'

До форматирования:

Image Added

После форматирования:

Image Added

Пример 3

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

'<div style="text-align:center">$(@value.y)</div>'

Image Added

(warning) Внимание! Для того, чтобы выполнилась данная команда, необходимо включить режим работы с HTML. Для этого выполните следующую команду в коде виджета:

w.plotOptions.series.dataLabels.useHTML = true

Image Added

Пример 4

Виджет Сводная таблица. Форматирование цвета текста и фона ячеек. Возможно использование различных цветовых форматов:

  • HTML имя цвета (например, red)

  • RGBA (например, rgba(225,0,0,225))

  • HEX (например, #ff0000)

Image Added

Дополнительные примеры форматирования см. в разделе Примеры форматирования.