Skip to content

Cascader Selection ​

Description ​

ItemContent
Control ClassControl Class
SortableYes
FilterableYes
Supported Filter TypesSingle Selection: Contains, Does Not Contain, Equal, Not Equal, Empty, Not Empty, In List, Not In List

Settings ​

SettingDescription
Allow emptySet whether the field is required
Multiple selectionWhen enabled, the cascader selection will support multiple selection. Enabling multiple selection will change the field's storage type
Allow selection at any levelWhen enabled, supports selecting intermediate nodes
Placeholder in form when not filledText information displayed in the input box when no information is entered in the field
Use option dictionary to get option valuesWhether to use the data dictionary in application settings as options
Option dictionary categoryWhen using the data dictionary in application settings as options, the data dictionary category used for list selection data
Option value typeCan use system preset option values
Options: Default、Province、Province and City、Province, City and District
Option valuesCan set the option values for this field. Only displayed when option value type is Default
Supported operations: Add、Copy from other fields、Add sub-options、Delete option
Use automation to set candidate listSupport using automation to filter the set option values
Automation input parametersParameters passed to automation based on context when calling automation for candidate values

Note

  • Single selection and multiple selection have different storage types. Enabling/disabling multiple selection may cause data loss, so please operate with caution. For conversion rules, refer to

  • When adding option values, a random code will be automatically generated as the option ID. You must modify the option ID according to the usage scenario to facilitate subsequent calls

  • Use automation to set candidate list:

    • The automation return value only supports the ID list Array<String> of option values.
    • The ID list returned by automation must be within the scope of the Identifier in the option values or data dictionary.
    • When the ID list returned by automation is null, all option values will be displayed.

Database Storage Format ​

Selection TypeField TypeDescriptionExample
Single Selectiontext[]Array{Guangdong,Shenzhen,Nanshan}
Multiple SelectionjsonbStore JSON data structure[["Shanghai", "City of Shanghai", "Huangpu District"], ["Shanghai", "City of Shanghai", "Pudong District"]]

Usage Examples ​

Basic Usage ​

Use Option Dictionary to Get Option Values ​

For option value field configuration, refer to

Option Value Type ​

The system has built-in Province, Province and City, Province, City and District data, which can be quickly configured to implement province-city-district selection.

Use Automation to Set Candidate List ​

Option definitions:

LevelOption ValueIdentifier
0Hunan1010
1Changsha1011
1Cixi1012
0Hubei1020
1Wuhan1021
1Xiangyang1022
0Guangdong2010
1Guangzhou2011
1Shenzhen2012

Return Only Parent Data ​

Return Only Child Data ​