Платформа 3V/Формы/Компоненты/Основные/Число: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показаны 2 промежуточные версии 1 участника)
Строка 1: Строка 1:
 +
Данный компонент предоставляет возможность вывода числовых данных.
 +
 
Пример визуального отображения компонента:
 
Пример визуального отображения компонента:
 +
 +
[[Файл:Число.jpg|обрамить|слева]]
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
 +
== Свойства и настройки компонента: ==
 +
{| class="wikitable"
 +
|-
 +
! Наименование настройки в интерфейсе !! Наименование свойства !! Тип !! Описание
 +
|-
 +
| Заголовок || label || строковый || Заголовок компонента
 +
|-
 +
| Отображать || visible || логический|| Флаг, отвечающий за видимость компонента
 +
|-
 +
| Включено || enable || логический || Флаг, отвечающий за доступность компонента
 +
|-
 +
| Текст заполнитель || placeholder || строковый || Текст, который будет выводиться в компоненте
 +
|-
 +
| Точность (число знаков после разделителя) || decCount || числовой || Точность (число знаков после разделителя)
 +
|-
 +
| Шаг счетчика || step || числовой || Шаг для счетчика
 +
|-
 +
| Минимальное значение || minNumber || числовой || Настройка минимального значения
 +
|-
 +
| Максимальное значение || maxNumber || числовой || Настройка максимального значения
 +
|-
 +
| Настройка валидации ||
 +
{| class="wikitable"
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
"validators": {
 +
        "validation": [
 +
          "maxNumber",
 +
          " minNumber "
 +
        ]
 +
      },
 +
</syntaxhighlight>
 +
|}
 +
||  || Настройка по максимальному или минимальному значению будет срабатывать валидация
 +
|-
 +
| Сообщение при валидации ||
 +
{| class="wikitable"
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
"validation": {
 +
        "messages": {
 +
          "maxNumber": "Максимум 10",
 +
          "minNumber": "Минимум 1"
 +
        }
 +
      },
 +
</syntaxhighlight>
 +
|}
 +
||  || Настройка сообщений, которые будут выводиться при валидации по максимальному и минимальному значению
 +
|-
 +
| Обязательное || required || логический || Флаг, включающий обязательность заполнения поля. У заголовка компонента появляется символ *. Если поле не заполнено, то ниже компонента выводится сообщение «Поле обязательно для заполнения»
 +
|-
 +
| Данные ||  ||  || Выбор справочника или отчета в качестве данных для компонента. Можно привязать источник данных - справочник, указать у него нужный атрибут, значение которого будет выводиться в компоненте. Можно выбрать отчет, указать строку/столбец, значение полученной ячейки будет выводиться в компоненте.
 +
|-
 +
| Значение по умолчанию || defaultValue || строковый || Значение по умолчанию
 +
|-
 +
| Выполнить действие при изменении значений || doActionOnChangeValue || логический || Флаг "Выполнить действие при изменении значения" активирует в серверной карточке флаг doActionOnChangeValue
 +
|-
 +
| CSS классы для компонента || className || строковый || Описание css классов для компонента
 +
|-
 +
| Описание для шаблона || templateDescription || строковый || Описание, которое выводится у компонента в режиме шаблона
 +
|}
 +
 +
== Пример. Описание в JSON формы ==
 +
{| class="wikitable"
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
{
 +
      "wrappers": [
 +
        "bs-form-field-inline"
 +
      ],
 +
      "key": "key1617698507913",
 +
      "type": "bs-number",
 +
      "dataSourceId": 1,
 +
      "templateOptions": {
 +
        "label": "Число (bs-number)",
 +
        "placeholder": "Введите сюда свое число",
 +
        "defaultValue": null,
 +
        "enable": true,
 +
        "visible": true,
 +
        "required": false,
 +
        "decCount": 2,
 +
        "maxNumber": 10,
 +
        "minNumber": 1,
 +
        "step": 0.01
 +
      },
 +
      "expressionProperties": {},
 +
      "validators": {
 +
        "validation": [
 +
          "maxNumber"
 +
        ]
 +
      },
 +
      "validation": {
 +
        "messages": {
 +
          "maxNumber": "Максимум 10",
 +
          "minNumber": "Минимум 1"
 +
        }
 +
      }
 +
    },
 +
</syntaxhighlight>
 +
|}

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

Данный компонент предоставляет возможность вывода числовых данных.

Пример визуального отображения компонента:

Число.jpg





Свойства и настройки компонента:

Наименование настройки в интерфейсе Наименование свойства Тип Описание
Заголовок label строковый Заголовок компонента
Отображать visible логический Флаг, отвечающий за видимость компонента
Включено enable логический Флаг, отвечающий за доступность компонента
Текст заполнитель placeholder строковый Текст, который будет выводиться в компоненте
Точность (число знаков после разделителя) decCount числовой Точность (число знаков после разделителя)
Шаг счетчика step числовой Шаг для счетчика
Минимальное значение minNumber числовой Настройка минимального значения
Максимальное значение maxNumber числовой Настройка максимального значения
Настройка валидации 
1 "validators": {
2         "validation": [
3           "maxNumber",
4           " minNumber "
5         ]
6       },
Настройка по максимальному или минимальному значению будет срабатывать валидация
Сообщение при валидации 
1 "validation": {
2         "messages": {
3           "maxNumber": "Максимум 10",
4           "minNumber": "Минимум 1"
5         }
6       },
Настройка сообщений, которые будут выводиться при валидации по максимальному и минимальному значению
Обязательное required логический Флаг, включающий обязательность заполнения поля. У заголовка компонента появляется символ *. Если поле не заполнено, то ниже компонента выводится сообщение «Поле обязательно для заполнения»
Данные Выбор справочника или отчета в качестве данных для компонента. Можно привязать источник данных - справочник, указать у него нужный атрибут, значение которого будет выводиться в компоненте. Можно выбрать отчет, указать строку/столбец, значение полученной ячейки будет выводиться в компоненте.
Значение по умолчанию defaultValue строковый Значение по умолчанию
Выполнить действие при изменении значений doActionOnChangeValue логический Флаг "Выполнить действие при изменении значения" активирует в серверной карточке флаг doActionOnChangeValue
CSS классы для компонента className строковый Описание css классов для компонента
Описание для шаблона templateDescription строковый Описание, которое выводится у компонента в режиме шаблона

Пример. Описание в JSON формы

 1 {
 2       "wrappers": [
 3         "bs-form-field-inline"
 4       ],
 5       "key": "key1617698507913",
 6       "type": "bs-number",
 7       "dataSourceId": 1,
 8       "templateOptions": {
 9         "label": "Число (bs-number)",
10         "placeholder": "Введите сюда свое число",
11         "defaultValue": null,
12         "enable": true,
13         "visible": true,
14         "required": false,
15         "decCount": 2,
16         "maxNumber": 10,
17         "minNumber": 1,
18         "step": 0.01
19       },
20       "expressionProperties": {},
21       "validators": {
22         "validation": [
23           "maxNumber"
24         ]
25       },
26       "validation": {
27         "messages": {
28           "maxNumber": "Максимум 10",
29           "minNumber": "Минимум 1"
30         }
31       }
32     },
Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Формы/Компоненты/Основные/Число&oldid=4229