Was können wir verbessern?

Dokumentation

(Bearbeiten)

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

Parameter

Parameter Beschreibung
caption sichtbare Beschriftung des DropDown-Menüs
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
label Beschriftung einer Auswahlmöglichkeit (veraltet)
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}
            ]
        }
    ]
}
Zum Warenkorb
Haben Sie noch Fragen?