Общая информация
Компонент позволяет выбрать пользователю месяц и год с помощью специального интерфейса без возможности выбора дня
Поддерживаемые экраны
Компонент может быть задействован на экране типа:
Внешний вид компонента
В услуге

В конструкторе

Структура компонента MonthPeaker
| ВКУ | JSON |
|
||
| № | В конструкторе | Атрибут | Тип | Описание |
| 1 | Идентификатор компонента | id | string | Уникальный идентификатор компонента в JSON |
| 2 | Удобочитаемое имя компонента | name | string | Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент |
| 3 | Заголовок компонента | label | string | Название поля. Описывает, что пользователю необходимо ввести в отображаемое ему поле |
| 4 | Поле является обязательным для заполнения? | required | boolean | Принуждает пользователя к взаимодействию с компонентом |
| Дополнительные атрибуты | ||||
| 5 | Отображение компонента в повторяющихся блоках (RepeatableFields) |
|
|
Можно выбрать отображение только в первом блоке или наоборот. Если оставить выпадающий список пустым, то компонент MonthPeaker будет отображаться во всех блоках компонента RepeatableFields |
| 6 | Минимально возможная валидная дата для выбора | minDate | string | Позволяет задать минимальную дату для выбора пользователем |
| 7 | Максимально возможная валидная дата для выбора | maxDate | string | Позволяет задать максимальную дату для выбора пользователем |
| Ограничения на вводимую дату с условием | ||||
| 8 | Условие сравнения с заданной датой | condition | string | Позволяет выбрать операцию сравнения |
| 9 | Ссылка/Постоянная величина | type | string |
Может принимать одно из двух значений:
|
| 10 | Значение | value | string | Позволяет ввести значение, с которым будет сравниваться поле |
| 11 | Установить зависимости с ранее введёнными данными | ref | array | Массив объектов, в элементах которых описываются зависимости и правила отображения полей |
| 12 | Настройка формирования health-метрик | healthList | array of objects | Позволяет задать список событий компонента, по которым будут формироваться health-запросы |
| 13 | Идентификатор подсказки/саджеста/suggest | suggestionId | string | Механизм отображения пользователю набора подходящих для ввода данных и автоматическое заполнение полей формы этими данными |
| 14 | Вычисляемые аргументы компонента (linkedValues) | linkedValues | array of objects | Атрибуты компонента, позволяющие реализовать сложный функционал |
Пример JSON структуры объекта передаваемой в DTO
|
{ "visited": true, "value": {"year":2023,"month":0,"monthCode":"JANUARY"}" } |
Варианты использования
Наиболее частым вариантом использования двух компонентов MonthPeaker является указание отрезка времени «с» — «по». В этом случае можно настроить компоненты так, чтобы дата окончания не была раньше, чем дата начала Для такой реализации потребуется настройка компонента, в котором указывается дата окончания. Используется блок «Ограничения на вводимую дату (с условием)», а сама настройка выглядит следующим образом:
