Element verbergen

Aktionen - Kurzfassung

Die Aktion Element verbergen löscht zur Laufzeit die Option "Sichtbar" für das verknüpfte Zielelement. Diese Option muss gesetzt sein, damit ein Element effektiv sichtbar sein kann. Ein Element, für das die Option "Sichtbar" nicht gesetzt ist, ist immer effektiv unsichtbar.

Siehe auch: Element anzeigen, Formularelemente

Die Aktion Element verbergen löscht zur Laufzeit die Option "Sichtbar" für das verknüpfte Zielelement. Diese Option muss gesetzt sein, damit ein Element effektiv sichtbar sein kann (s. Hinweise unten). Ein Element, für das die Option "Sichtbar" nicht gesetzt ist, ist immer effektiv unsichtbar.

WICHTIG◄ Ein Element, das als Pflichtfeld gekennzeichnet ist, muss auch gefüllt sein, wenn es effektiv unsichtbar ist. Dagegen sind ggf. konfigurierte Validierer für das Element nur wirksam, wenn es effektiv sichtbar ist. Die Aktion Element verbergen beeinflusst deshalb unter Umständen nicht nur das Validierungsergebnis des Elements, sondern auch die Validierung übergeordneter Elemente bis hin zum Formular.

images/download/attachments/189433140/image-2024-10-8_11-8-37-version-1-modificationdate-1728378516892-api-v2.png

  • Die Aktion kann unter Typ der Aktion nur ausgewählt werden, wenn ein Zielelement verknüpft ist.

  • Die Eigenschaft "Sichtbar" ist für sämtliche Formularelemente verfügbar, so dass ein beliebiges Zielelement außer dem Formular-Element selbst verknüpft werden kann.

HINWEISE

  • Das Zielelement wird durch die Aktion Element verbergen zur Laufzeit immer effektiv unsichtbar.

  • Wird ein Zielelement vom Typ Element Container verborgen, dann werden auch sämtliche direkt und indirekt untergeordneten Elemente effektiv unsichtbar. Sofern diese selbst "sichtbar gesetzt" sind, gelten sie dann als latent sichtbar.

Beispiel

In einer Erfassungsmaske für Sendungen soll eine Gruppe von Eingaben zu "Besonderheiten" der Sendung durch eine Checkbox "Keine Besonderheiten" pauschal gelöscht werden. Dabei sollen auch der betreffende Zeilenlayout-Container ausgeblendet werden, bis die Checkbox ggf. wieder gelöscht wird.

Laufzeit-Beispiel:

images/download/attachments/189433140/image2020-6-19_15-56-14-version-1-modificationdate-1728378511149-api-v2.png

  • Für eine neue Sendung werden die "Besonderheiten" zunächst angezeigt. Für einige der Optionen (im Bild: "Abstellgenehmigung") werden ggf. weitere Eingabefelder (im Bild: "Abstellort") eingeblendet.

images/download/attachments/189433140/image2020-6-19_16-5-27-version-1-modificationdate-1728378511155-api-v2.png

  • Beim Setzen der Option "Keine Besonderheiten" verschwindet der Zeilenlayout-Container mit den Besonderheiten.

images/download/attachments/189433140/image2020-6-19_16-7-57-version-1-modificationdate-1728378511158-api-v2.png

  • Wenn die Option danach wieder aktiviert wird, sind vorherigen Einträge gelöscht.
    WICHTIG◄ Die Aktion Element verbergen löscht die Einträge nicht. Dies muss ebenso separat geregelt werden, wie das Ein-/Ausblenden für das Textfeld "Abstellort" abhängig von der Checkbox "Abstellgenehmigung".

Konfiguration:

images/download/attachments/189433140/image-2024-10-8_12-6-43-version-1-modificationdate-1728382003659-api-v2.png

Für das Checkbox-Element "Keine Besonderheiten" wird das links abgebildete Verhalten konfiguriert:

  • Aus Auslöser sind hier Geändert (mit dem Änderungstyp "Exklusiv durch den Benutzer") und Formulardaten geladen eingetragen. Da die Checkbox kein Datenfeld besitzt, wird sie beim Laden von Formulardaten gelöscht.


  • Die Verhaltensweise Gefüllt löst beim Setzen der Checkbox die Aktionen bei "wahr" aus.


  • Unter den Aktionen bei "wahr" wird die Aktion .Element verbergen v4.12.0 mit dem Zeilenlayout-Container "Besonderheiten" als Zielelement ausgeführt.


  • Abschließend folgt dann noch die Aktion Verhalten ausführen, die das Verhalten mit dem Namen "reset" für dasselbe Zielelement aufruft. Dieses Verhalten (nicht im Bild) setzt durch eine Serie von Wert setzen-Aktionen die alle Elemente innerhalb der "Besonderheiten" zurück. Sonst würden beim Löschen der Checkbox bereits vorgenommene Einstellungen wieder erscheinen. Beim Speichern der Sendung würden diese Werte außerdem trotz des ausgeblendeten Zustands geschrieben.