Il gestore eventi validate

La funzione validate gestisce gli errori di convalida causati dai dati nella vista.

Utilizzo

La funzione validate contiene la logica per visualizzare gli indicatori o altri programmi di notifica che indicano che si è verificato un problema con i dati. Il framework inizia con la funzione validate nelle viste parent prima di chiamare la funzione validate nelle relative viste child.

Il gestore eventi validate è il momento in cui si desidera fornire visualizzazioni e comportamenti di errore personalizzati. Consultare i controlli stock per esempi di logica di presentazione. Ad esempio, il controllo stock di testo cambia colore e visualizza un'icona di errore quando contiene dati non validi. L'icona di errore ha una guida a comparsa che visualizza il messaggio associato alla condizione di errore.

L'oggetto evento

La funzione validate utilizza un singolo oggetto evento. Il tipo di oggetto evento è error o clear. Un evento error indica che uno script o un servizio di validazione ha rilevato uno o più errori e che la vista deve gestire gli errori per visualizzare una visualizzazione appropriata. Un evento clear significa che la visualizzazione deve rimuovere la visualizzazione risultante da un eventoerror precedente.

Un evento di errore può avere due elenchi di oggetti di errore. Un elenco è denominato errors e l'altro è denominato errors_subscription. Le viste collegate a un business object ricevono automaticamente gli errori. Inoltre, ricevono automaticamente gli errori per tutte le viste discendenti collegate allo stesso business object.

Tabella 1. Proprietà degli oggetti di errore nell'elenco di errori
Proprietà Immettere Descrizione
binding String Contiene il percorso del bind di dati relativo al bind di dati della vista corrente.
message String Contiene il messaggio localizzato che descrive l'errore.
view_dom_ids[] String[List] Contiene l'elenco di ID DOM delle viste che ricevono lo stesso messaggio di errore. L'elenco può includere la vista corrente e qualsiasi vista discendente.
Le viste che richiamano subscribeValidation() ricevono alcuni errori nell'elenco errors_subscription . Questi errori si verificano nelle viste discendenti collegate a un oggetto di business diverso rispetto alla vista corrente. Le viste che non hanno un bind di dati, come il controllo stock della scheda, devono richiamare subscribeValidation() per ricevere errori.
Tabella 2. Proprietà degli oggetti di errore nell'elenco errors_subscription
Proprietà Immettere Descrizione
messages String[List] Contiene un elenco di messaggi di errore localizzati
view_dom_id String Contiene l'ID DOM della vista con i dati non validi.
Un oggetto evento error potrebbe essere simile al seguente esempio:
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 oggetto evento di clear non contiene proprietà. Una vista utilizza l'oggetto clear per rimuovere gli indicatori di errore per le viste che ora dispongono di dati validi.