Evento OnChange de la columna (referencia de la API de cliente)

  • Artículo

El evento OnChange se produce en las siguientes situaciones:

  • Los datos de una columna de formulario cambian y se pierde el foco. Hay una excepción a este comportamiento que se aplica a columnas Sí/No que están formateadas para usar botones de opción o casillas de verificación. En estos casos, el evento se produce inmediatamente.
  • Los cambios de datos en el servidor se recuperan para actualizar una columna cuando se actualiza el formulario, como después de guardar un registro.
  • Se usa el método attribute.fireOnchange.

Todas las columnas admiten el evento OnChange. Los datos de la columna se validan antes y después del evento OnChange.

El evento OnChange no se produce si la columna se cambia programáticamente usando el método attribute.setValue. Si desea que los controladores de eventos para el evento OnChange se ejecuten después de configurar el valor, debe usar el método formContext.data.entity attribute.fireOnchange. en el código. El evento OnChange tampoco ocurre si la columna se cambia programáticamente al descartar los cambios si el usuario está navegando para salir de un formulario sucio.

Nota

Aunque la columna Estado respalda el evento OnChange, la columna es de solo lectura en el formulario, por lo que el evento no se puede producir a través de la interacción del usuario. Otro script podría hacer que este evento ocurriera usando el método fireOnchange en la columna.

Nota

Los eventos OnChange son sincrónicos. No debería usar código asincrónico en un controlador de eventos OnChange que necesite que se realice o maneje una acción sobre la resolución del código asincrónico. Esto causa problemas si el controlador de resolución espera que el contexto de la aplicación siga siendo el mismo que cuando se inició el código asincrónico. Igualmente, no debería realizar solicitudes de red sincrónicas en un controlador de eventos OnChange. Esto puede hacer que una aplicación no responda.

Métodos admitidos para este evento

Hay tres métodos que puede utilizar para trabajar con el evento OnChange para una columna:

Columnas (referencia de la API de cliente)

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).