Събитие 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 на клиент)
Събития във формуляри и мрежи в приложения, управлявани от модел