¶ Complete JSON Object
{
"key": "InputKey",
"type": "customdropdown",
"props": {
"label": "Input Name",
"required": true,
"placeholder": "Input Placeholder",
"bindLabel": "description",
"bindValue": "id",
"multiple": false,
"options": [
{ "id": "male", "description": "Male" },
{ "id": "female", "description": "Female" }
]
},
"validation": {
"messages": {
"required": "Error message for required"
}
}
}
¶ Description
This widget is a simple dropdown with predefined static options. Unlike dynamic dropdowns, it does not fetch data from an API. Each option has:
id: the actual value bound to the field.description: the label displayed to the user.
Setting bindValue to "id" means the field value will be "male" or "female" instead of the full object.
¶ Props Overview
| Prop | Type | Description |
|---|---|---|
label |
string | Field label |
placeholder |
string | Placeholder text |
bindLabel |
string | Object property to display in dropdown (description) |
bindValue |
string | Object property to bind as value (id) |
multiple |
boolean | Allows selecting multiple items |
options |
array | Array of static objects with id and description |
required |
boolean | Marks field as mandatory |
¶ Use Cases
- Selecting gender, status, or fixed categories.
- When values are known and static.
- Quick dropdowns without server calls.
-
Complete JSON Object
{ "key": "InputKey", "type": "customdropdown", "props": { "label": "Input Name", "required": true, "placeholder": "Input Placeholder", "bindLabel":"description", "bindValue":"id", "multiple":false, "options":[ { "id":"male", "description":"Male" }, { "id":"female", "description":"Female" } ], }, "validation": { "messages": { "required": "Error message for required" } } }## UI Configuration¶ In Widget tab
¶ Settings
¶ Display Rule
-
Allowed Custom Properties
-
Allowed Validations
validator-(n)
- Missing to be configured via UI
- Conditional validations
- Default value
- Display rule: display when another field is valid
- Display rule based on integration response: Having the response structure configured before hand to eliminate the user typing the response field key to use
- Of which field?