« Zurück zu Produkt

Dokumentation

Feedback senden!

PopupButton

Benötigt: IP-Symcon >= 5.0

Erstellt einen Button, welcher durch einen Klick ein Popup öffnet, welches weitere Formularfelder enthält.

Beispiel

Allgemeine Parameter

Parameter Beschreibung
caption Sichtbare Beschriftung des Buttons
download (optional) (default: "") Ist dieser Parameter nicht leer und beinhaltet die Ausgabe des onClick-Skriptes eine Data-URL, so wird die Rückgabe als Textdatei mit dem Namen das download-Parameters heruntergeladen. (ab IP-Symcon 7.0)
enabled (optional) (default: true) Bei true kann der Button verwendet werden, ansonsten wird er deaktiviert dargestellt. Dieser Parameter hat keine Auswirkung auf ein möglicherweise geöffnetes Popup (ab IP-Symcon 5.2)
link (optional) (default: false) Ist dieser Parameter true, dann wird die Ausgabe des onClick-Skriptes als Link geöffnet. Ist er false, so wird die Ausgabe als Dialog im Konfigurationsformular angezeigt. (ab IP-Symcon 6.0)
name (optional) Name des PopupButtons
onClick (optional) (default: "") Skript, welches bei einem Klick auf den Button ausgeführt wird. Sofern das Skript aus mehreren Zeilen besteht, können die einzelnen Zeilen auch als Array übergeben werden (Arrays werden ab Version 6.0 unterstützt). Es hat die gleichen Eigenschaften wie onClick des Button (ab IP-Symcon 5.3)
popup Definition des zu öffnenden Popups (Parameter sind ab IP-Symcon 6.1 änderbar durch Verknüpfung der Paramternamen, beispielsweise popup.closeCaption)
type PopupButton
visible (optional) (default: true) Bei true ist der Button sichtbar, ansonsten ist er unsichtbar. Dieser Parameter hat keine Auswirkung auf ein möglicherweise geöffnetes Popup (ab IP-Symcon 5.2)
width (optional) Feste Breite des Buttons in Pixel oder % als String, z.B. "40%" oder "250px". Ist der Wert nicht gesetzt oder "", wird die Breite automatisch auf Basis der Beschriftung gewählt (ab IP-Symcon 5.2)

Parameter für popup

Parameter Beschreibung
buttons (optional) (default: []) Eine Liste von Buttons welche im Popup unten rechts dargestellt wird. An erster Stelle wird immer der Schließen-Button dargestellt, danach folgen die hier beschriebenen Buttons in Reihenfolge (ab IP-Symcon 6.1)
caption (optional) (default: "") Sichtbarer Titel des Popups
closeCaption (optional) (default: "Schließen") Die Beschriftung des Schließen-Buttons unten rechts im Popup (ab Version 6.1)
items Auflistung von Formularfeldern im Popup (nicht änderbar)

Parameter für buttons

Parameter Beschreibung
caption Sichtbare Beschriftung des Buttons
onClick Skript, welches bei einem Klick auf den Button ausgeführt wird. Sofern das Skript aus mehreren Zeilen besteht, können die einzelnen Zeilen auch als Array übergeben werden. Es sind keine PHP-Tags erforderlich. Es hat die gleichen Eigenschaften wie onClick des Button. Sofern das Skript keine Ausgabe macht, wird das Popup nach Abarbeitung des Skriptes geschlossen. Ansonsten wird die Ausgabe als rote Fehlermeldung unten im Popup angzeigt. Eine Ausnahme besteht hier wenn die Rückgabe mit dem Präfix "MESSAGE:" beginnt. In diesem Fall wird das Popup geschlossen und die Rückgabe hinter dem Präfix in einem Meldungsdialog angezeigt.
enabled (optional) (default: true) Bei true kann der Button verwendet werden, ansonsten wird er deaktiviert dargestellt

Beispiel

{
            "type": "PopupButton",
            "caption": "Open Popup",
            "popup": {
                "caption": "My Element Popup",
                "items": [
                    {
                        "type": "SelectVariable",
                        "name": "VariableTest",
                        "caption": "Some Variable"
                    }
                ]
            }
        }
Haben Sie noch Fragen?