Dokumentation
Select
Erstellt ein DropDown-Menü mit der Überschrift caption.
Falls im "elements"-Bereich erstellt, setzt das DropDown-Menü eine Eigenschaft bei Übernahme auf den ausgewählten Wert value.
Der Parameter "name" definiert dabei welche Eigenschaft gesetzt wird.
Bei MultiSelect ist darauf zu achten, dass alle Value-Arrays die gleichen Namen beinhalten
Wird Select innerhalb von Listen verwendet, gibt es kein MultiSelect.
![Beispiel](/media/pages/service/dokumentation/entwicklerbereich/sdk-tools/sdk-php/konfigurationsformulare/select/77b965f7b7-1723640927/konfigurationsformulare-select.png)
Parameter
Parameter | Beschreibung |
---|---|
caption | Sichtbare Beschriftung des DropDown-Menüs |
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 das DropDown-Menü verwendet werden, ansonsten wird es 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 des DropDown-Menüs/der zu setzenden Eigenschaft |
options | Array, welches alle Auswahlmöglichkeiten beinhaltet |
onChange (optional) | (default: "") Skript, welches bei einer Veränderung des Dropdown-Wertes 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 | Select |
value (optional) | (default: erste definierte Option) Der Wert des DropDown-Menüs - 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 das DropDown-Menü sichtbar, ansonsten ist es unsichtbar (ab IP-Symcon 5.2) |
width (optional) | (default: 300px) Feste Breite des Dropdown-Menüs in Pixel oder % als String, z.B. "40%" oder "250px" (ab IP-Symcon 5.3) |
Parameter für options
Parameter | Beschreibung |
---|---|
caption | Beschriftung einer Auswahlmöglichkeit |
value | Wert der bei Auswahl übergeben wird. Kann auch ein weiteres Array beinhalten, welches mehreren Eigenschaften die Werte übergibt. |
Beispiel
//Einfache Valueübergabe //Eigenschaft "DeviceType" wird auf 0..3 gesetzt //DropDown-Menü hat 4 Einträge { "type": "Select", "name": "DeviceType", "caption": "Einheit", "options": [ { "caption": "Bit (1Bit)", "value": 0 }, { "caption": "Bits (2Bit)", "value": 1 }, { "caption": "Bits (4Bit)", "value": 2 }, { "caption": "Byte (8Bit)", "value": 3 } ] } //Mehrfache Valueübergabe (MultiSelect) //"name" des Select (hier: "OutputDevice") muss gesetzt sein, wird jedoch nicht zum Setzen der Werte genutzt. //Eigenschaften "DeviceName", "DeviceChannels" und "DeviceNum" werden gesetzt. { "type": "Select", "name": "OutputDevice", "caption": "Ausgabegerät", "options": [ {"caption" : "No sound", "value": [ {"name": "DeviceName", "value": "No sound"}, {"name": "DeviceChannels", "value": 0}, {"name": "DeviceNum", "value": 0} ] }, {"caption" : "Kopfhörer", "value": [ {"name": "DeviceName", "value": "Kopfhörer"}, {"name": "DeviceChannels", "value": 2}, {"name": "DeviceNum", "value": 1} ] }, {"caption" : "Lautsprecher", "value": [ {"name": "DeviceName", "value": "Stereolautsprecher"}, {"name": "DeviceChannels", "value": 2}, {"name": "DeviceNum", "value": 2} ] } ] }