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

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

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

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

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

= Валидация значений произвольным кодом =
[[Файл:Блоки Validation, Misc, Help.png|мини|Блок Validation в параметрах свойства]]
Платформа позволяет валидировать вводимые в свойства значения, для этого есть 3 основных механизма - маска, шаблон  и произвольный код. Первые два механизма описаны в [[Хранение данных. Классы. Поля и действия|обзорной статье]] по свойствам классов.

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

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

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

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

Пример кода для валидации:<syntaxhighlight lang="javascript">
if (value_ !== '234') return 'Должно быть 234!';  else return true;
</syntaxhighlight>В данном примере, происходит проверка значения и сравнение его со строкой 234, если оно не совпадает, то пользователю будет выведено сообщение "Должно быть 234!".


Пример кода без указания строки для вывода:<syntaxhighlight lang="javascript">
if (value_ !== '234') return false;  else return true;
</syntaxhighlight>В этом примере, при неуспешной валидации будет выведено сообщение validationMessage (если оно заполнено), либо системное сообщение по умолчанию.

= Динамическое скрытие и отображение свойств =
[[Файл:Группа Card.png|мини|Группа Card]]
Платформа позволяет скрывать и отображать свойства на карточке в зависимости от произвольных условий. Например, скрывать одни свойства, в зависимости от значений в других свойствах. Этот механизм является динамическим и работает без обновления карточки, т.е. если в результате работы с карточкой, условия для отображения начали выполняться, то скрытое поле автоматически отобразится.

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

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

Простейший пример кода:<syntaxhighlight lang="javascript">
this.mode === 'ext'
</syntaxhighlight>В этом случае поле text будет отображаться на карточка только если значение поля mode 'ext'.


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

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

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


По аналогии с видимостью можно управлять редактируемостью полей через свойство readOnlyConditionCode, которое также находится в группе Card<syntaxhighlight lang="javascript">
this.mode === 'ext'
</syntaxhighlight>В этом случае пользователь сможет изменить значение поля text только если значение поля mode равно 'ext'

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

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

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

ETicketStatus.open

Пример кода для сравнения:<syntaxhighlight lang="javascript">
this.status === ETicketStatus.open
</syntaxhighlight>

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

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

Примеры:<syntaxhighlight lang="javascript">
this.linkedTicket_id == '387a0acf-ee49-4d51-bd39-887f34979911'
</syntaxhighlight><syntaxhighlight lang="javascript">
this.linkedTicket_id == this.previousTicket_id

</syntaxhighlight>

= Проверка пустых значений =
Для проверки пустых (незаполненных) значений любых типов, можно использовать сравнение с null:<syntaxhighlight lang="javascript">
this.ticket_id==null
</syntaxhighlight>



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

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