Skip to content

Validatoren ​

Mit Validatoren prüfen Sie, ob bestimmte Bedingungen bei einer Eingabe-Komponente erfüllt sind. Validatoren werden als unsichtbare Hilfsknoten unter die Komponente gehängt und automatisch ausgewertet – bei jeder Eingabe in der Eltern-Komponente und vor jedem Backend-Event der View.

Verfügbare Validatoren ​

ValidatorPrüft
Validator EmptyIst die Komponente leer?
Validator MinLiegt die Eingabe unter einer Mindestlänge?
Validator MaxÜbersteigt die Eingabe eine Maximallänge?
Validator RegexMatcht die Eingabe einen regulären Ausdruck?

Mögliche Eltern-Komponenten ​

Validatoren dürfen an folgende Komponenten gehängt werden. Sie ziehen den Validator aus der Funktionsliste der Sidebar in den View-Tree auf die jeweilige Komponente:

  • Input
  • TextArea
  • ComboBox
  • Time Picker

Kombination mehrerer Validatoren ​

Sie können mehrere Validator-Arten an einer Komponente kombinieren. Beispiel: Ein Passwortfeld, das nicht leer sein darf und zwischen 8 und 20 Zeichen lang sein muss:

  • Validator Empty (valueStateText: „Pflichtfeld")
  • Validator Min (minLength: 8, valueStateText: „Mindestens 8 Zeichen")
  • Validator Max (maxLength: 20, valueStateText: „Höchstens 20 Zeichen")

Attribute ​

Validator Empty ​

AttributBeschreibung
controlIdEindeutige ID des Validators. Wird automatisch generiert.
valueStateTextAnzuzeigende Nachricht, wenn der Wert der Eltern-Komponente leer ist.

Validator Min ​

AttributBeschreibung
controlIdEindeutige ID des Validators. Wird automatisch generiert.
minLengthMinimale Anzahl an Zeichen, die der Wert haben darf. Wird der Wert unterschritten, erscheint eine Nachricht. Ein leerer Wert gilt als gültig – kombinieren Sie mit Validator Empty, wenn das Feld Pflicht ist.
valueStateTextAnzuzeigende Nachricht bei Unterschreiten der Mindestlänge.

Validator Max ​

AttributBeschreibung
controlIdEindeutige ID des Validators. Wird automatisch generiert.
maxLengthMaximale Anzahl an Zeichen. Wird der Wert überschritten, erscheint eine Nachricht.
valueStateTextAnzuzeigende Nachricht bei Überschreiten der Maximallänge.

Validator Regex ​

AttributBeschreibung
controlIdEindeutige ID des Validators. Wird automatisch generiert.
patternRegulärer Ausdruck, gegen den der Wert geprüft wird. Ein leerer Wert gilt als gültig – kombinieren Sie mit Validator Empty, wenn das Feld Pflicht ist.
valueStateTextAnzuzeigende Nachricht, wenn der Ausdruck nicht matcht.

Beispiel-Patterns ​

Zweckpattern
E-Mail-Adresse^[^@]+@[^@]+\.[^@]+$
Deutsche PLZ^\d{5}$
Telefon (international)^\+?[0-9 \-]{6,}$
Hex-Farbe^#[0-9A-Fa-f]{6}$

Validierung ​

Validatoren laufen automatisch – bei jeder Eingabe in der Eltern-Komponente (liveChange; bei Komponenten ohne Live-Eingabe beim change) sowie vor jedem Backend-Event der View. Schlägt dabei ein Validator im View-Baum fehl, wird das Event nicht an das Backend gesendet. Die betroffene Komponente wird farblich markiert (Error-Status) und der valueStateText angezeigt. Einen eigenen Logic-Flow-Baustein zum Auslösen der Validierung gibt es nicht.

Nächste Schritte ​

  • Logic Flow – ergänzende Frontend-Logik
  • Mobile-Builder-API (On-Prem / Cloud) – Wertzustand und Fehlertext aus ABAP setzen (set_value_state, set_value_state_text)