Платформа 3V/Формы/Диаграммы/Гистограмма: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Метка: новое перенаправление
 
(не показано 35 промежуточных версий 2 участников)
Строка 1: Строка 1:
При настройке [[Платформа 3V/Формы/Дашборд|дашборда]] можно создать гистограмму. Гистограмма - способ графического отображения данных в виде столбчатой диаграммы.
+
#redirect [[Платформа 3V/Формы/Компоненты/Графики/Гистограмма]]
 
 
== Описание свойств templateOptions ==
 
{| class="wikitable"
 
|-
 
! Наименование !! Свойство !! Тип !! Описание
 
|-
 
| Тип диаграммы || type || строковый || Выбор типа диаграммы
 
|-
 
! colspan="4" style="text-align:center;"| '''Заголовок диаграммы'''
 
|-
 
| Главный заголовок || title || строковый || Задание заголовка диаграммы
 
|-
 
| Размер шрифта || fontSizeTitle || строковый || Размер шрифта заголовка диаграммы
 
|-
 
| Цвет заголовка || titleColor || строковый || Настройка цвета заголовка
 
|-
 
| Выравнивание по вертикали || titleVerticalAlign || строковый || Выравнивание заголовка по вертикали
 
|-
 
| Отступ сверху || titleMargin || числовой || Отступ заголовка диаграммы сверху
 
|-
 
| Выравнивание по горизонтали || titleAlign || строковый || Выравнивание заголовка по горизонтали: центр, слева, справа
 
|-
 
| Выравнивание по вертикали || titleVerticalAlign || строковый || Выравнивание заголовка по вертикали: верх, центр, низ
 
|-
 
! colspan="4" style="text-align:center;"|'''Заголовок  осей'''
 
|-
 
| Заголовок по X || textX || строковый || Заголовок оси X
 
|-
 
| Заголовок по Y || textY || строковый || Заголовок оси Y
 
|-
 
| Включить сортировку || dataSorting || логический || Флаг, при включении которого к данным применяется сортировка
 
|-
 
| Отразить по x || xAxisReversed || логический || Флаг, при включении которого данные по оси x будут перевернуты
 
|-
 
| Отразить по y || yAxisReversed || логический || Флаг, при включении которого данные по оси y будут перевернуты
 
|-
 
| Показать сетку || axisGridLines || логический || Флаг, при включении которого данные по оси y будет отображена сетка
 
|-
 
| Стиль линий сетки || dashStyleAxisGridLines || строковый || Выбор одного из стилей линий сетки: Сплошная, Пунктир, Длинный пунктир, Точка
 
|-
 
| Показать вертикальные линии || axisGridLines || логический || Флаг, при включении которого по оси y будет отображена сетка
 
|-
 
| Цвет вертикальных линий || yLineColor || строковый || Настройка цвета вертикальных линий
 
|-
 
! colspan="4" style="text-align:center;"| '''Настройки диаграммы'''
 
|-
 
| Цвет линий сетки по X || xGridLineColor || строковый || Настройка цвета сетки по X
 
|-
 
| Цвет линии по X || xLineColor || строковый || Настройка цвета линии по X
 
|-
 
| Цвет линий сетки по Y || yGridLineColor || строковый || Настройка цвета сетки по X
 
|-
 
| Цвет линии по Y || yLineColor || строковый || Настройка цвета линии по Y
 
|-
 
| Ширина диаграммы || chartWidth || числовой || Настройка ширины области диаграммы
 
|-
 
| Высота диаграммы || chartHeight || числовой || Настройка высоты области диаграммы
 
|-
 
| Фон || bgColor || строковый || Настройка цвета фона диаграммы
 
|-
 
| Граница || bdWidth || строковый || Настройка толщины границы области диаграммы
 
|-
 
| Цвет границы || bgColor || строковый || Настройка цвета границы области диаграммы
 
|-
 
| Ширина столбиков || colWidth|| числовой || Настройка ширины столбиков диаграммы
 
|-
 
| Ширина линии графика || lineWidth || строковый || Настройка ширины линии графика
 
|-
 
| Цвет линии графика || lineColor|| строковый || Настройка цвета линии графика
 
|-
 
| Вид баров || typeBar || строковый || Выбор одного из видов баров: Простой, Столбчатая с накоплением, Процент
 
|-
 
| Расположение рядов || rowCol|| строковый || Выбор расположения рядов: Строка, Столбец
 
|-
 
| Номер строка/колонки с заголовками || nameColumn || строковый || Номер строки/колонки с заголовками
 
|-
 
| Номер строка/колонки с подписями || nameSing || строковый || Номер строки/колонки с подписями
 
|-
 
! colspan="4" style="text-align:center;"| '''Ряды данных'''
 
|-
 
| Скрывать, если данные пустые || hideDataIfEmpty || логический || Флаг, при включении которого ряды с пустыми данными не отображаются
 
|-
 
| Отобразить все данные рядов || isAllColumns || логический || Флаг, при включении которого отображаются все колонки данными
 
|-
 
| Диапазон с данными || rowData || строковый || Если настройка выше отключена, то должна быть возможность задать диапазон с данными с виде: 1-2
 
|-
 
|| Отобразить все ряды || isAllRows || логический || Флаг, при включении которого отображаются все ряды
 
|-
 
| Диапазон с рядами || nameColumn || строковый || Если настройка выше отключена, то должна быть возможность задать диапазон с рядами с виде: 1-2
 
|-
 
| Скругление углов || nameSing || строковый || Задание значения скругления углов столбиков диаграммы
 
|-
 
! colspan="4" style="text-align:center;"| '''Значение'''
 
|-
 
| Отображать максимальные значения || showMaxLabels || логический || Флаг, при включении которого выводятся максимальные значения
 
|-
 
| Отображать значения || showLabels || логический || Флаг, при включении которого выводятся все значения
 
|-
 
| Выравнивание по горизонтали || alignLabels|| строковый || Выравнивание значения по горизонтали: Центр, Слева, Справа
 
|-
 
| Выравнивание по вертикали || verticalAlignLabels|| строковый|| Выравнивание значения по вертикали: Низ, Центр, Верх
 
|-
 
| Цвет значений || colorLabels|| строковый || Настройка цвета текста значений
 
|-
 
| Фон значений || bgColorLabels|| строковый || Настройка цвета фона значений
 
|-
 
| Контур текста || textOutlineLabels|| логический || Флаг, при включении которого у текста значений будет отображаться контур
 
|-
 
| Размер шрифта || fontSizeLabels|| строковый || Настройка размера шрифта значений
 
|-
 
| Отступ слева || marginLeftLabels|| числовой || Настройка отступа слева для значений
 
|-
 
| Отступ сверху || marginTopLabels|| числовой || Настройка отступа сверху для значений
 
|-
 
| Суффикс || suffixLabels|| строковый || Суффикс у значений
 
|-
 
! colspan="4" style="text-align:center;"| '''Подписи осей'''
 
|-
 
| Отображать подписи || showSignatures || логический  || Флаг, при включении которого отображаются подписи на осях
 
|-
 
| Цвет подписи по X  || xLabelsColor || строковый|| Настройка цвета подписи по X
 
|-
 
| Цвет подписи по Y  || yLabelsColor || строковый|| Настройка цвета подписи по Y
 
|-
 
| Ограничить подписи || shortSignatures || логический  || Флаг, при включении которого можно ограничить подпись
 
|-
 
| Максимальное число символов || numberLetters|| числовой || Настройка количества символов для ограничения подписей
 
|-
 
! colspan="4" style="text-align:center;"| '''Легенда'''
 
|-
 
| Отображать легенду || showLegend || логический || Флаг, при включении которого будет отображаться легенда
 
|-
 
| Положение || positions|| строковый || Настройка положения легенды: снизу, сверху
 
|-
 
| Фон  || bgColorLegend || строковый || Настройка цвета фона легенды
 
|-
 
| Граница || bdWidthLegend|| строковый || Настройка ширины границы
 
|-
 
| Цвет границы || bdColorLegend|| строковый || Настройка цвета границы
 
|-
 
| Отображать тень || shadowLegend || логический || Флаг, при включении которого у легенды будет отображаться тень
 
|-
 
| Радиус скругления символа || symbolRadiusLegend || числовой || Радиус скругления символа для типов серий. При отрицательном значении выводится квадратный символ
 
|-
 
| Выполнить действие при изменении значений || doActionOnChangeValue || логический|| Флаг, включение которого активирует в серверной карточке флаг doActionOnChangeValue
 
|-
 
| CSS классы для компонента || className || строковый || Описание css классов для компонента
 
|-
 
| Описание для шаблона || templateDescription|| строковый || Описание, которое выводится у компонента в режиме шаблона
 
|-
 
| Стиль линий сетки || dashStyleAxisGridLines || строковый || Выбор одного из стилей линий сетки: Сплошная, Пунктир, Длинный пунктир, Точка
 
|-
 
! colspan="4" style="text-align:center;"| '''Цвета'''
 
|-
 
| Включить градиент || colorsGradient || логический  || Флаг, при включении которого можно задать цвета градиента
 
|-
 
| Цвета || colors || массив || Список заданных цветов
 
|-
 
| Цвет|| color || строковый || Настройка цвета для градиента
 
|}
 
 
 
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
 
<div style="font-weight:bold;line-height:1.6;"> Пример JSON гистограммы</div>
 
<div class="mw-collapsible-content mw-collapsed-content">
 
<syntaxhighlight lang="JSON" line>
 
{
 
          "key": "1",
 
          "type": "trv-highcharts",
 
          "templateOptions": {
 
            "fontSizeTitle": "20",
 
            "titleAlign": "left",
 
            "dataSorting": false,
 
            "xAxisReversed": false,
 
            "yAxisReversed": false,
 
            "axisGridLines": true,
 
            "dashStyleAxisGridLines": "Solid",
 
            "showYLines": false,
 
            "chartWidth": null,
 
            "chartHeight": null,
 
            "type": "column",
 
            "hardTreeMap": false,
 
            "borderColorTreeMap": "#e6e6e6",
 
            "typeBar": "",
 
            "rowCol": "row",
 
            "pieDir": false,
 
            "pieConnector": false,
 
            "showShadow": false,
 
            "widthShadow": 5,
 
            "opacityShadow": 0.1,
 
            "pieLabelDistance": "30",
 
            "pieInnerSize": "0",
 
            "variablePieSizeByValue": [],
 
            "hideDataIfEmpty": false,
 
            "isAllColumns": true,
 
            "isAllRows": true,
 
            "plotLines": [],
 
            "showMaxLabels": false,
 
            "showLabels": false,
 
            "alignLabels": "center",
 
            "verticalAlignLabels": "bottom",
 
            "colorLabels": "contrast",
 
            "textOutlineLabels": true,
 
            "fontSizeLabels": "11",
 
            "marginLeftLabels": 0,
 
            "marginTopLabels": 0,
 
            "suffixLabels": "",
 
            "showSignatures": true,
 
            "shortSignatures": false,
 
            "numberLetters": 10,
 
            "showLegend": true,
 
            "positions": "bottom",
 
            "bdWidthLegend": 0,
 
            "shadowLegend": false,
 
            "symbolRadiusLegend": 6,
 
            "colorsGradient": false,
 
            "colors": [],
 
            "showCode": false,
 
            "code": "{\n  \"title\": {},\n  \"chart\": {\n    \"type\": \"column\"\n  },\n  \"xAxis\": {\n    \"categories\": [],\n    \"title\": {}\n  },\n  \"yAxis\": {\n    \"title\": {}\n  },\n  \"legend\": {\n    \"verticalAlign\": \"bottom\",\n    \"borderWidth\": 0,\n    \"shadow\": false\n  },\n  \"plotOptions\": {\n    \"series\": {\n      \"stacking\": \"\"\n    }\n  },\n  \"series\": [\n    {\n      \"type\": \"column\",\n      \"name\": \"\",\n      \"data\": [\n        \"{{2:2}}\"\n      ]\n    }\n  ]\n}",
 
            "nameColumn": "1",
 
            "nameSing": "1",
 
            "titleColor": "#888888",
 
            "titleVerticalAlign": "top",
 
            "xGridLineColor": "#000000",
 
            "xLineColor": "#00000",
 
            "yGridLineColor": "#000000",
 
            "yLineColor": "#000000"
 
          },
 
          "dataSourceId": 309
 
        }
 
</syntaxhighlight>
 
</div></div>
 
 
 
== Пример использования ==
 
Кейс: Вывести гистограмму, показывающую количество шагов сделанных за день
 
[[Файл:Гистограма 2.0.png|1600px|никакой|центр]]
 
 
 
====== Создать отчёт с данными, на которых будет строиться гистограмма ======
 
[[Файл:Пивот кол-во шагов.png|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br><br><br><br>
 
 
 
====== Создать форму ======
 
В форму следует добавить источник данных и элемент.
 
 
 
====== Настроить источник данных ======
 
[[Файл:источник данный.png|700px|мини|слева]]
 
<br><br><br><br><br>
 
 
 
====== Настроить вывод данных ======
 
Для того, чтобы данные отображались в виде столбцов, обозначающими кол-во шагов и подписями с датами, необходимо в поле "Расположение рядов" выбрать "столбец" и задать номер строки с подписями
 
[[Файл:Расположение рядов.png|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br>
 
 
 
====== Настроить заголовок диаграммы ======
 
Для того, чтобы создать заголовок достаточно написать его в поле "Главный заголовок".
 
[[Файл:Настройка заголовка.png|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 
Настройка стиля заголовка производится с помощью полей "Размер шрифта" и "Цвет заголовка"
 
[[Файл:цвет заголовка.png|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 
Настройка расположения заголовка производится с помощью полей "Отступ сверху",  "Выравнивание по горизонтали" и "Выравнивание по вертикали".
 
[[Файл:Расположение заголовка.png|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br>
 
 
 
====== Настроить сетку ======
 
Для того, чтобы отобразить сетку требуется поставить отметку в "Показать сетку".
 
[[Файл:отображение сетки.png|мини|слева]]
 
<br><br><br><br><br><br><br>
 
После этого следует настроить цвета отображения сетки. Для того, чтобы одна линия сетки не отображалась нужно настроить ей цвет фона(по умолчанию #ffffff)
 
[[Файл:цвет сетки.png|мини|слева]]
 
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 
 
 
====== Настроить легенду ======
 
 
 
Для того, чтобы отобразить сетку следует поставить отметку в "Отображать легенду". Легенду можно расположить сверху и снизу регулируется это полем "Положение". Границу легенды можно задать путем обозначение ее ширины в поле "Граница", её цвет можно настройть в "Цвет границы". По умолчанию символ в легенде обозначающий цвет данных на диаграмме квадратный, изменить его форму можно в поле "Радиус скругления углов".
 
[[Файл:Легенда.png|мини|слева]]
 

Текущая версия на 08:31, 16 сентября 2021