Die Checkboxliste ermöglicht eine Mehrfachauswahl aus einer vordefinierten Liste von Optionen. Im Gegensatz zum Dropdown oder der Radioliste können hier mehrere Optionen gleichzeitig ausgewählt werden.
Die Optionswerte und Labels werden in den Feldeinstellungen der Entität definiert.
Als Wert einer Option sind auch Zahlen erlaubt, zum Beispiel die Term-IDs von WordPress-Kategorien: In der WordPress-Integration lassen sich die Taxonomien (Kategorien, Schlagwörter) genau aus einer Checkboxliste befüllen, deren Optionswerte die Term-IDs sind. 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.
Ausgabe
Die Ausgabe unterscheidet sich je nach Kontext.
API
Gibt nur die ausgewählten Werte als Array zurück:
"checkboxen": ["1", "3"]SDK / Nitro CMS
Gibt ein Objekt mit values (ausgewählte Werte), options (alle verfügbaren Optionen) und labels (Labels der ausgewählten Werte) zurück:
"checkboxen": {
"values": [1, 3],
"options": {
"1": "Option A",
"2": "Option B",
"3": "Option C"
},
"labels": ["Option A", "Option C"]
}Leerer Wert
"checkboxen": []"checkboxen": {
"values": [],
"options": [],
"labels": []
}