El manejador de sucesos de validate

La función validate maneja los errores de validación causados por los datos de la vista.

Uso

La función validate contiene la lógica para visualizar indicadores o algún otro notificador que indica que hay un problema con los datos. La infraestructura se inicia con la función validate en las vistas padre antes de llamar a la función validate en sus vistas hijo.

El manejador de sucesos de validate es para cuando desea proporcionar visualizaciones de errores y comportamiento personalizados. Consulte los controles estándar para ver ejemplos de la lógica de presentación. Por ejemplo, el control estándar Texto cambia el color y visualiza un icono de error cuando contiene datos que no son válidos. El icono de error tiene ayuda contextual que visualiza el mensaje asociado con la condición de error.

Objeto de suceso

La función validate toma un único objeto de suceso. El tipo del objeto de suceso es error o clear. Un suceso de error significa que un script o servicio de validación ha detectado uno o más errores y que la vista debe manejar los errores para visualizar una visualización adecuada. Un suceso clear significa que la vista debe eliminar la visualización resultante de un sucesoerror anterior.

Un suceso de error puede tener dos listas de objetos de error. Una lista se denomina errors y la otra se denomina errors_subscription. Las vistas enlazadas a un objeto de negocio reciben automáticamente errores para ellas mismas. También reciben automáticamente errores para todas las vistas descendientes enlazadas al mismo objeto de negocio.

Tabla 1. Propiedades de los objetos de error en las listas de errores
Propiedad Tipo Descripción
binding String Contiene la vía de acceso al enlace de datos relativa al enlace de datos de la vista actual.
message String Contiene el mensaje localizado que describe el error.
view_dom_ids[] String[List] Contiene la lista de ID de DOM de las vistas que reciben el mismo mensaje de error. La lista puede incluir la vista actual y cualquiera de sus vistas descendientes.
Las vistas que llaman a subscribeValidation() reciben determinados errores en la lista errors_subscription. Estos errores se producen en vistas descendientes enlazadas a un objeto de negocio distinto a la vista actual. Las vistas que no tienen un enlace de datos, tales como el control estándar de pestaña, deben invocar subscribeValidation() para recibir errores.
Tabla 2. Propiedades de los objetos de error en la lista errors_subscription
Propiedad Tipo Descripción
messages String[List] Contiene una lista de mensajes de error localizados
view_dom_id String Contiene el ID de DOM de la vista con los datos no válidos.
Es posible que un objeto de suceso de error sea similar al ejemplo siguiente:
type: "error",
errors: 
	[
		{
			binding: "birthday.year"
			message: "The year you entered, 2013, is after current year of 2012.",
			view_dom_ids: ["domId_ProfileView", "domId_yearView"]
		}
	]
errors_subcription: 
	[
		{
			view_dom_id: "domId_accountView",
			messages: ["Enter your account number."]
		}
	]

Un objeto de suceso clear no contiene propiedades. Una vista utiliza el objeto clear para eliminar los indicadores de error para las vistas que ahora tienen datos válidos.