Erscheinungsbild
Validatoren
Mit Validatoren prüfen Sie, ob bestimmte Bedingungen bei einem Eingabefeld oder einer TextArea erfüllt sind. Validatoren werden als unsichtbare Hilfsknoten unter die Komponente gehängt und automatisch ausgewertet, wenn die Eingabe geprüft werden soll.
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
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. |
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. |
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 auslösen
Validatoren werden nicht automatisch bei jeder Eingabe ausgewertet. Sie lösen die Prüfung üblicherweise in einer Event-Methode der angebundenen Backend-Klasse aus (etwa beim onPress eines Submit-Buttons) oder per Logic Flow. Die Komponente wird dabei farblich markiert (Error-Status) und der valueStateText als Tooltip angezeigt.
Nächste Schritte
- Logic Flow – Validierung im Frontend-Flow auslösen
- Mobile-Builder-API – Validierung aus ABAP-Code triggern