Dynamic Select
- The drop-down menu is a clear method of showing a list of data, allowing users to pick their choice from the list.
- This input field is controlled by the dynamic field handler.
Note: For optimum results configure the dynamic_select field only when the search results are more than 100. In case of results lesser than 100, use the select field.
Attribute Name | Datatype | Description |
type* | String (Value should be dynamic_select) | The type of the input field. Value of the field should be dynamic_select. |
placeholder* | String (150) | Sample field value displayed to the user that describes the expected value of the input field. |
name* | String (50) | A unique identifier for the field. Upon form submission, value defined for this key will be available in the function associated with the form. |
label* | String (150) | Describes the display name for this field. |
hint | String (100) | Provides a brief description of the fields purpose and the expected input. |
value | String(100) | Provide a default input value for the field. |
mandatory | Boolean | Defines if the field's requisite is mandatory or not. Note: Default value is considered to be false. |
options* | Array | An array of JSON object following the structure label and value. This attribute will be considered only when the datasource is list. Max no of elements - 100 } Note: The first level of options can have another set of options. |
multiple | Boolean | Define if your drop-down should be a single select or multi select field. For all multi select fields, multiple should be set as true. |
max_selections | Integer Maximum selections: 10 | Defines the number of options that a user can choose from the drop-down. Note: Value for this field defaults to 1 in case of single select drop-downs. |
auto_search_min_results | Integer Default: 5 | The number of drop-down items to be populated when the search results are less than this count. |
min_characters | Integer | Minimum number of characters required to trigger the search. |
disabled | Boolean | If disabled is true, then the field will not be editable |
trigger_on_change | Boolean | If this is enabled for a field or an input, then the change handler will be invoked when the value of that field is changed |
Sample Code:
Copied{
"type":"dynamic_select",
"name":"dynamic_select",
"label":"Items",
"hint":"Choose an item",
"placeholder":"Choose an item",
"mandatory":false,
"multiple":true,
"trigger_on_change":true,
"options":[
{
"label":"Wardrobe",
"value":"wardrobe"
},
{
"label":"Double Bed",
"value":"doublebed"
}
],
"value":"wardrobe",
"auto_search_min_results":5,
"min_characters":3,
"max_selections":2,
"disabled" : true
}
JSON format passed in handlers for the filled-in value:
Copied{
"meta":{
"type":"dynamic_select",
"value":"wardrobe"
},
"value":[
{
"label":"Wardrobe",
"value":"wardrobe"
}
]
}