Dokumentation
CheckBox
Erstellt eine Checkbox.
Falls im "elements"-Bereich erstellt, setzt die Checkbox eine Eigenschaft bei Übernahme auf True oder False.
Der Parameter "name" definiert dabei welche Eigenschaft gesetzt wird.
Parameter
| Parameter | Beschreibung |
|---|---|
| caption | Sichtbare Beschriftung |
| download (optional) | (default: "") Ist dieser Parameter nicht leer und beinhaltet die Ausgabe des onChange-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 die CheckBox verwendet werden, ansonsten wird sie deaktiviert dargestellt (ab IP-Symcon 5.2) |
| link (optional) | (default: false) Ist dieser Parameter true, dann wird die Ausgabe des onChange-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 der Checkbox/der zu setzenden Eigenschaft |
| onChange (optional) | (default: "") Skript, welches bei einer Veränderung der Checkbox durch einen Klick 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.2) |
| type | CheckBox |
| value (optional) | (default: false) Der Wert der CheckBox - Sofern es eine dazugehörige Eigenschaft gibt, wird dieser Parameter im elements-Bereich durch die Eigenschaft überschrieben (ab IP-Symcon 5.2) |
| visible (optional) | (default: true) Bei true ist die CheckBox sichtbar, ansonsten ist sie unsichtbar (ab IP-Symcon 5.2) |
| width (optional) | Feste Breite der Checkbox 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.3) |
Beispiel
{ "type": "CheckBox", "name": "status", "caption": "Status emulieren" }