Column OnChange event (Client API reference)

O OnChange suceso ocorre nas seguintes situacións:

  • Os datos dunha columna de formulario cambiaron e pérdese o foco. Hai unha excepción a este comportamento que se aplica ás columnas Si/Non que están formatadas para usar botóns de opción ou caixas de verificación. Nestes casos o suceso ocorre de forma inmediata.
  • Os cambios de datos no servidor obtéñense para actualizar unha columna cando se actualiza o formulario, por exemplo despois de gardar un rexistro.
  • Utilízase o método attribute.fireOnchange .

Todas as columnas apoian o OnChange evento. Os datos da columna son validados antes e despois do OnChange evento.

O OnChange evento non ocorre se a columna se cambia programáticamente usando o método attribute.setValue . Se queres que os xestores de eventos para o OnChange evento se executen despois de establecer o valor, debes usar o formContext.data.entity attribute. método fireOnchange no teu código. O OnChange evento tampouco ocorre se a columna se cambia programáticamente ao descartar os cambios se o usuario está navegando fóra dun formulario sucio.

Nota

Aínda que a columna Estado admite oOnChange evento, a columna é só de lectura no formulario, polo que o evento non pode ocorrer a través da interacción do usuario. Outro script podería causar que se produza este evento usando o método fireOnchange na columna.

Nota

OnChange Os eventos son síncronos. Non debe usar código asíncrono nun OnChange xestor de eventos que necesita unha acción para ser tomada ou xestionada sobre a resolución do código asíncrono. Isto causa problemas se o xestor de resolución espera que o contexto da aplicación permaneza igual que cando se iniciou o código asíncrono. Tampouco debe realizar solicitudes de rede síncronas nun xestor de eventos OnChange. Isto pode provocar que a aplicación non responda.

Métodos soportados para este evento

Hai tres métodos que podes usar para traballar co OnChange evento dunha columna:

Columnas (Referencia da API do cliente)
Eventos (referencia da API do cliente)
Eventos en formularios e cuadrículas en aplicacións baseadas en modelos