Cascader
级联选择
级联选择控件, 对应自关联模型字段的渲染, 单选复选根据关联关系是 toOne toMany 来决定.
API
ICascaderProps
| 参数 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| levelField | string | 字段为json数组的场景下,控件可以依据此字段判断数组元素层级 | - |
| allowSelectParent | boolean | - | - |
| allowClear | boolean | - | - |
| parentField | string | 父节点字段名,该属性必填 | - |
| hasChildrenField | string | 是否存在子节点字段名,与isLeafField属性必须至少配置一个 | - |
| isLeafField | string | 是否为叶子节点字段名,与hasChildrenField属性必须至少配置一个 | - |
| leafOnly | boolean | 是否只能选择叶子节点 | - |
| valueField | string | valueField,该属性已弃用,默认为id,不可配置 | - |
| modalTitle | string | 自定义控件的模态框标题 | - |
| dataCondition | string | 筛选条件,“id==1” | - |
| searchCondition | string | 外层select搜索时的筛选条件,“level==2” | - |
| extraFields | string | 配置需要额外获取的字段,“field1,field2,field3” | - |
| optionFormat | string | 下拉选项可自定义,可用的字段默认包含mainField,其它字段通过extraFields 传入 | - |
| depthLimit | number | 最大展示层级(最大值为4) | - |
| enableSelectLevel | number | 指定可选择的层级数(最大值为4) | - |
| dataSource | string | 数据来源 | - |
| columnTitles | string[] | 各类目标题 | - |
| linkSelectMode | boolean | 是否开启父子接点关联合并选项,例如,全选子级节点,只返回父级节点id | - |
| dataSourceContext | IDictionary | IDictionary[] | dataSourceContext , v2 即将废除 | - |
| openModalOnClick | boolean | 是否通过点击事件打开弹窗 | - |
| dataParams | string | 配合dataSource入参,object格式,请求时会merge到search中 | - |
| onlyShowPanel | boolean | 是否直接展示级联面板 | - |
| labelField | string | 显示的节点名称 | - |
| searchable | boolean | 是否可搜索,是否显示搜索框 | true |
| showLevelSelectAll | boolean | 是否支持层级全选 | false |
| orderField | string | 获取节点列表时的排序字段名称,配合order属性使用 | - |
| order | ’asc’ | ‘desc’ | 获取节点时的排序规则,配合orderField属性使用 | - |
| modalWidth | string | number | 自定义弹窗宽度,可设置具体宽度或者百分比 | - |
用法
<View title="Cascade" version="2"> <Form model="trade_TradeBaseOrderBO"> <Fields> <Field name="receiveAddress.districtList" label="地址"> <RenderType> <Cascader extraFields="districtCode,districtLevel" parentField="parentDistrict" model="md_DistrictBO" valueField="id" labelField="districtName" levelField="districtLevel" /> </RenderType> </Field> </Fields> </Form></View>