Поделиться через


Событие Column OnChange (справочник по API клиента)

Событие OnChange происходит в следующих ситуациях:

  • Данные в столбце формы изменились, и фокус теряется. Существует исключение из этого поведения, которое применяется к столбцам "Да/нет", отформатированным для использования переключателей или флажков. В этих случаях событие происходит немедленно.
  • Изменения данных на сервере извлекаются для обновления столбца при обновлении формы, например после сохранения записи.
  • Используется метод attribute.fireOnchange .

Все столбцы поддерживают OnChange событие. Данные в столбце проверяются до и после OnChange события.

Событие OnChange не происходит, если столбец изменяется программным способом с помощью метода attribute.setValue . Если вы хотите, чтобы обработчики событий выполнялись OnChange после задания значения, необходимо использовать formContext.data.entity attribute. метод fireOnchange в коде. Событие OnChange также не происходит, если столбец изменяется программным образом при отмене изменений, если пользователь переходит от грязной формы.

Замечание

Хотя столбец "Состояние "OnChange поддерживает событие, столбец доступен только для чтения в форме, поэтому событие не может произойти через взаимодействие с пользователем. Другой сценарий может привести к возникновению этого события с помощью метода fireOnchange в столбце.

Замечание

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

Методы, поддерживаемые для этого события

Существует три метода, которые можно использовать для работы с событием для столбца OnChange :

Столбцы (справочник по КЛИЕНТСКОму API)
События (справочник по API клиента)
События в формах и сетках в приложениях на основе моделей