Ereignishandler für validate

Die Funktion validate verarbeitet Gültigkeitsfehler, die durch die Daten in der Ansicht verursacht werden.

Verwendung

Die Funktion validate enthält die Logik zum Anzeigen von Anzeigern oder anderen Benachrichtigungen im Zusammenhang mit Datenproblemen. Das Framework startet die Funktion validate zuerst in den übergeordneten Ansichten, bevor die Funktion validate in den untergeordneten Ansichten aufgerufen wird.

Über den Ereignishandler für validate können angepasste Fehlerdarstellungen und ein diesbezüglich angepasstes Verhalten bereitgestellt werden. Beispiele für die Darstellungslogik bieten die integrierten Steuerelemente. Das integrierte Text-Steuerelement ändert beispielsweise die Farbe und zeigt ein Fehlersymbol an, wenn es ungültige Daten enthält. Das Fehlersymbol verfügt über eine Kurzinfo mit der Nachricht, die der Fehlerbedingung zugeordnet ist.

Ereignisobjekt

Für die Funktion validate wird ein einzelnes Ereignisobjekt verwendet. Der Typ des Ereignisobjekts ist error oder clear. Ein Ereignis vom Typ error gibt an, dass ein Prüfservice oder ein Script mindestens einen Fehler festgestellt hat und die Ansicht diese Fehler verarbeiten muss, um eine entsprechende Darstellung anzuzeigen. Ein Ereignis des Typs clear gibt an, dass die Ansicht die Darstellung entfernen muss, die aus einem früheren error-Ereignis resultiert ist.

Ein Fehlerereignis kann zwei Listen mit Fehlerobjekten enthalten. Die eine Liste hat den Namen errors und die andere hat den Namen errors_subscription. An ein Geschäftsobjekt gebundene Ansichten empfangen für sich selbst automatisch Fehler. Außerdem empfangen sie Fehler für alle untergeordneten Ansichten, die an dasselbe Geschäftsobjekt gebunden sind.

Tabelle 1. Eigenschaften der Fehlerobjekte in der Fehlerliste
Eigenschaft Typ Beschreibung
binding String Enthält den Pfad zur Datenbindung relativ zur Datenbindung der aktuellen Ansicht.
message String Enthält die lokalisierte Nachricht, die den Fehler beschreibt.
view_dom_ids[] String[List] Enthält die Liste mit den DOM-IDs der Ansichten, die dieselbe Fehlernachricht empfangen. Die Liste kann die aktuelle Ansicht und jede der untergeordneten Ansichten enthalten.
Ansichten, die subscribeValidation() aufrufen, empfangen bestimmte Fehler in der Liste errors_subscription. Diese Fehler treten in untergeordneten Ansichten auf, die an ein anderes Geschäftsobjekt als die aktuelle Ansicht gebunden sind. Ansichten, die über keine Datenbindung verfügen (z. B. das integrierte Registerkarten-Steuerelement), müssen subscribeValidation() aufrufen, um Fehler zu empfangen.
Tabelle 2. Eigenschaften der Fehlerobjekte in der Liste 'errors_subscription'
Eigenschaft Typ Beschreibung
messages String[List] Enthält eine Liste mit lokalisierten Fehlernachrichten.
view_dom_id String Enthält die DOM-ID der Ansicht mit den ungültigen Daten.
Ein Ereignisobjekt des Typs error kann beispielsweise wie folgt aussehen:
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."]
		}
	]

Ein Ereignisobjekt des Typs clear enthält keine Eigenschaften. Eine Ansicht verwendet das Objekt clear zum Entfernen der Fehleranzeiger für Ansichten, die nun über gültige Daten verfügen.