Dokumentation
PopupButton
Benötigt: IP-Symcon >= 5.0
Erstellt einen Button, welcher durch einen Klick ein Popup öffnet, welches weitere Formularfelder enthält.

Allgemeine Parameter
Parameter | Beschreibung |
---|---|
caption | Sichtbare Beschriftung des Buttons |
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 | 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" } ] } }