Das Dropdown-Feld ermöglicht es, genau eine Option aus einer vordefinierten Liste auszuwählen. Die Optionen werden in den Feldeinstellungen der Entität definiert. Für eine Mehrfachauswahl kann stattdessen die Checkboxliste verwendet werden.
Die Optionswerte und Labels werden in den Feldeinstellungen der Entität definiert. Labels können optional mehrsprachig sein.
Als Wert einer Option sind auch Zahlen erlaubt, zum Beispiel die Term-IDs von WordPress-Kategorien; einzig 0 ist als Wert nicht möglich. Die Optionen erscheinen im Formular in der festgelegten Reihenfolge oder, wenn in den Feldeinstellungen so gewählt, alphabetisch nach Label sortiert. Felder aus der Zeit vor dieser Erweiterung zeigen ihre Optionen zunächst schreibgeschützt an und werden mit «Migrieren» auf das neue Format umgestellt; die Umstellung wird mit dem nächsten Speichern übernommen.
Verfügbare Filter
| Filter | Beschreibung |
|---|---|
option_label | Gibt nur das Label der ausgewählten Option zurück |
option_value | Gibt nur den Wert/Key der ausgewählten Option zurück |
Ausgabe
Die Ausgabe unterscheidet sich je nach Kontext.
API
Gibt nur den Wert (Key) der ausgewählten Option zurück:
"dropdown": "1"SDK / Nitro CMS
Gibt ein Objekt mit value (ausgewählter Wert), options (alle verfügbaren Optionen) und label (Label des ausgewählten Wertes) zurück:
"dropdown": {
"value": "1",
"options": {
"1": "Option 1",
"2": "Option 2"
},
"label": "Option 1"
}Leerer Wert
Ist keine Option ausgewählt, sind value und label im SDK und im Nitro CMS null und options ist eine leere Liste. label ist ausserdem null, wenn der gespeicherte Wert keine der Optionen mehr ist.
"dropdown": false"dropdown": {
"value": null,
"options": [],
"label": null
}