Отображение данных. Динамическая работа с полями

Предыдущая статья курса: Отображение данных. Вкладки, группы, таблицы

Общая информация

Доступные операции с полями (свойствами) в контролах:

• Валидация значений (произвольный код)
• Динамическое скрытие/отображение
• Динамический запрет изменения значения (readonly)

Использование данного функционала и дальнейшие примеры требуют базовых знаний языка JavaScript. Данные операции строятся на базе условных конструкций языка и используют клиентскую объектную модель платформы Эра.

Все возможные операции настраиваются в параметрах свойства, на вкладке UI.

Валидация значений произвольным кодом

Блок Validation в параметрах свойства

Платформа позволяет валидировать вводимые в свойства значения, для этого есть 3 основных механизма - маска, шаблон и произвольный код. Первые два механизма описаны в обзорной статье по свойствам классов.

Произвольный код для валидации задается в свойстве validationCode и переопределяет остальные настройки валидации, включая значение validationMessage, т.е. выводимое сообщение может также определяться кодом.

Код должен возвращать один из трёх вариантов:

• true - валидация успешна
• false - валидация неуспешна, использовать для вывода validationMessage
• произвольная строка - валидация неуспешна, использовать для вывода предоставленную строку

Для доступа к значению, введенному в свойства, необходимо использовать переменную value_

Пример кода для валидации:

if (value_ !== '234') return 'Должно быть 234!';  else return true;

В данном примере, происходит проверка значения и сравнение его со строкой 234, если оно не совпадает, то пользователю будет выведено сообщение "Должно быть 234!".

Пример кода без указания строки для вывода:

if (value_ !== '234') return false;  else return true;

В этом примере, при неуспешной валидации будет выведено сообщение validationMessage (если оно заполнено), либо системное сообщение по умолчанию.

Динамическое скрытие и отображение свойств

Группа Card

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

Для этого свойству можно задать параметр visibilityConditionCode (редактор свойства, вкладка UI, группа Card).

Введенный в данное поле код должен возвращать true в случае если поле необходимо отобразить и false, если поле отображать нельзя.

Простейший пример кода:

this.mode === 'ext'

В этом случае поле text будет отображаться на карточка только если значение поля mode 'ext'.

Группы и вкладки автоматически скрываются, если в них не остается ни одного видимого элемента. При этом если в customItems явно задано условие видимости вкладки (аналогично полю - через visibilityConditionCode), данное правило применяться не будет.

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

Динамический признак readonly

По аналогии с видимостью можно управлять редактируемостью полей через свойство readOnlyConditionCode, которое также находится в группе Card

this.mode === 'ext'

В этом случае пользователь сможет изменить значение поля text только если значение поля mode равно 'ext'

Сравнение значений перечислений (Enum)

При использовании перечислений в различных условиях, для того чтобы сравнивать значения полей с конкретными значениями перечислений необходимо обращаться к ним без кавычек:

E+[Имя перечисления].[Имя(name) элемента перечисления]

Пример для перечисления TicketStatus, значения open:

ETicketStatus.open

Пример кода для сравнения:

this.status === ETicketStatus.open

Сравнение ссылочных значений

При сравнении ссылочных значений, к названию свойства необходимо добавлять постфикс _id.

В поле соответственно, будет храниться идентификатор объекта, на который хранится ссылка.

Примеры:

this.linkedTicket_id == '387a0acf-ee49-4d51-bd39-887f34979911'

this.linkedTicket_id == this.previousTicket_id

Проверка пустых значений

Для проверки пустых (незаполненных) значений любых типов, можно использовать сравнение с null:

this.ticket_id==null

Следующая статья курса: Задание 5. Сложная карточка

Предыдущая статья курса: Отображение данных. Вкладки, группы, таблицы