Skip to content

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

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

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.
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.
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 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