Erscheinungsbild
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
| Validator | Prüft |
|---|---|
| Validator Empty | Ist die Komponente leer? |
| Validator Min | Liegt die Eingabe unter einer Mindestlänge? |
| Validator Max | Übersteigt die Eingabe eine Maximallänge? |
| Validator Regex | Matcht 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
| Attribut | Beschreibung |
|---|---|
controlId | Eindeutige ID des Validators. Wird automatisch generiert. |
valueStateText | Anzuzeigende Nachricht, wenn der Wert der Eltern-Komponente leer ist. |
Validator Min
| Attribut | Beschreibung |
|---|---|
controlId | Eindeutige ID des Validators. Wird automatisch generiert. |
minLength | Minimale 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. |
valueStateText | Anzuzeigende Nachricht bei Unterschreiten der Mindestlänge. |
Validator Max
| Attribut | Beschreibung |
|---|---|
controlId | Eindeutige ID des Validators. Wird automatisch generiert. |
maxLength | Maximale Anzahl an Zeichen. Wird der Wert überschritten, erscheint eine Nachricht. |
valueStateText | Anzuzeigende Nachricht bei Überschreiten der Maximallänge. |
Validator Regex
| Attribut | Beschreibung |
|---|---|
controlId | Eindeutige ID des Validators. Wird automatisch generiert. |
pattern | Regulä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. |
valueStateText | Anzuzeigende Nachricht, wenn der Ausdruck nicht matcht. |
Beispiel-Patterns
| Zweck | pattern |
|---|---|
| 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)