CascadeModelSelect
级联弹窗选择
级联选择控件, 对应自关联模型字段的渲染, 单选复选根据关联关系是 toOne toMany 来决定.
API
ICascadeModelSelectProps
| 参数 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| 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 | 自定义弹窗宽度，可设置具体宽度或者百分比 | - |
IModelSelectProps
| 参数 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| condition | string | 获取数据时的筛选条件 | - |
| createAction | string | boolean | function | 配置 ModelSelect控件的 新增 操作对应的 ViewAction， 值为 true 时使用对应模型的默认 Form 视图，值为函数时，直接调用 | - |
| createActionWithContext | boolean | 新增时是否带上表单上下文 | - |
| dataSource | (params: ILogicDataParams) => Promise<IDataSourceResult> | IDataSourceResult | 配置此字段后容器会通过dataSource获取数据，可用于mock或获取自定义数据 | - |
| modalTitle | string | 自定义控件的模态框标题 | - |
| extraFields | string | 配置需要额外获取的字段，“field1,field2,field3”, 如果要获取关联模型字段: “field4.field0” | - |
| optionFormat | (option: IDictionary) => string | 下拉选项可自定义，可用的字段默认包含mainField，其它字段通过extraFields 传入 | - |
| placeholder | string | 占位符 | - |
| dataParams | string | 用法的数据容器有差异，必须使用表达式写法 :dataParams | - |
| dataCondition | string | 用法的数据容器类似。dataCondition="" 表示使用空条件请求 | - |
| dataFlow | string | 使用此属性表示控件将从LogicFlow请求数据, dataFlow=“key” | - |
| dataFunction | string | 使用此属性表示控件将从LogicFunction请求数据，dataFunc=“key” | - |
| dataFunc | string | 使用此属性表示控件将从LogicFunction请求数据，dataFunc=“key” | - |
| mute | boolean | 下拉/弹框时不请求数据 | - |
| selectFirst | boolean | 是否默认选中第一项，需配合autoLoad使用 | - |
| autoLoad | boolean | 说明: 是否自动加载数据，一般配合selectFirst（选中第一项）一起使用 | - |
| simpleValueMode | boolean | 单值模式[id1,id2,id3] | - |
| orderField | string | 用于排序的字段名 | - |
| order | ’desc’ | ‘asc’ | 排序方式 | - |
| fuzzySearchable | boolean | 隐藏模糊搜索框 | - |
| labelField | string | 显示的节点名称 | - |
| scroll | scroll | 设置modelSelect popover里Table的滚动高度 | - |
| singleSelect | boolean | 单选模式 | - |
| valueField | string | value字段名称，组件将会从选中记录中提取该字段，作为回填值。 | ‘id’ |
condition 条件筛选格式见: Condition 语法
用法
<View title="CascadeModelSelect" version="2"> <Form model="trantor_doc_Person"> <Fields> <Field name="department"> <RenderType> <CascadeModelSelect /> </RenderType> </Field> </Fields> </Form></View>注意：当前例子为0.17.x 版本