Общая информация
Компонент позволяет выбрать пользователю месяц и год с помощью специального интерфейса без возможности выбора дня
Поддерживаемые экраны
Компонент может быть задействован на экране типа:
Внешний вид компонента
В услуге
В конструкторе
Структура компонента 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 является указание отрезка времени «с» — «по». В этом случае можно настроить компоненты так, чтобы дата окончания не была раньше, чем дата начала Для такой реализации потребуется настройка компонента, в котором указывается дата окончания. Используется блок «Ограничения на вводимую дату (с условием)», а сама настройка выглядит следующим образом: