Gefüllt

Die Verhaltensweise Gefüllt wertet ein zu prüfendes Formularelement aus, um festzustellen, ob es im aktuellen Zustand als "gefüllt" oder "nicht gefüllt" gilt.

images/download/attachments/189431853/image-2024-9-30_8-32-30-version-1-modificationdate-1727677949281-api-v2.png

Das zu prüfende Formularelement wird abhängig vom Bestehen einer Elementverknüpfung wie folgt ermittelt:

  • Ist kein Element verknüpft, wird das das ausführende Element geprüft.

  • Ist ein Element verknüpft, wird dieses Element geprüft.

Unterstützt das zu prüfende Formularelement dem Typ nach die Prüfung auf gefüllt, dann werden die Aktionen bei "wahr" ausgeführt, wenn das Element als gefüllt gilt. Sonst werden die Aktionen bei "falsch" ausgeführt.

Ist das zu prüfende Formularelement dem Typ nach ungeeignet für die Prüfung, erscheint außerdem eine Fehlermeldung ("No validator found [...]") in der Entwicklerkonsole des Browsers.

Unabhängig vom Verlauf der Prüfung werden anliegende Eingabedaten ($input) unverändert an die Aktionen weitergegeben.

HINWEIS◄ Wird das Gefüllt-Verhalten z. B. für einen Button (mit Auslöser Angeklickt) konfiguriert, um ein verknüpftes Element zu prüfen, lautet der Wert von $input immer true, weil das verknüpfte Element zwar geprüft aber sein Wert nicht als Eingabedaten übernommen wird.

Hinweise zur Prüfung ausgewählter Formularelemente

Formularelement

Prüfung möglich

Hinweise

Checkbox

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

  • Gefüllt liefert nur "wahr", wenn der Wert "true" ist (Haken gesetzt).

  • Leer und "false" (kein Haken) gelten als "nicht gefüllt", können aber ggf. per $input differenziert werden.

Textfeld

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

Der Wert in einem Textfeld wird vor der Prüfung getrimmt, so dass das Textfeld nicht als Gefüllt gilt, wenn es nur Whitespace-Zeichen (Leerzeichen, Zeilenwechsel, usw.) enthält.

Datumsbereich

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

Ein Datumsbereich gilt nur als Gefüllt, wenn beide enthaltenen Datumskomponenten ("Von", "Bis") gefüllt sind. Abhängig von Details beim interaktiven Bearbeiten von Datumskomponenten kann dies gelegentlich zu unerwarteten Ergebnissen führen. Bei Bedarf können die Komponenten individuell per Gefüllt geprüft und z. B. über eine Logische Verknüpfung verknüpft werden.

Listenelemente

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

Die unterschiedlichen Listenelemente können grundsätzlich geprüft werden. Abhängig vom Typ bezieht sich die Prüfung auf die enthaltene Liste oder die auf deren Basis getroffene Auswahl:

HINWEIS◄ Auch wenn der Schlüsselwert einer Auswahl (etwa in einem Auswahlfeld/Combobox-Element mit statischen Werten) einem "leeren" Textwert (Whitespace oder leere Zeichenfolge) entspricht, gilt das Element mit dieser Auswahl als Gefüllt.

Wiederholendes Element

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

Ein Wiederholendes Element gilt als Gefüllt, wenn mindestens ein Eintrag (eine Instanz des wiederholten Elements) vorhanden ist.

Optionale Elemente

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg

Ein Optionale Elemente Container unterstützt keine Prüfung auf Gefüllt.

Elemente ohne interaktiven Zugriff
(ohne Anspruch auf Vollständigkeit)

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg