功能说明
许多组件都会显示选项列表,如下拉单选、下拉多选、级联单选等。每个选项包含许多设置,具体取决于组件(如value、label等等)
一些组件允许您手动配置每个选项,或者通过映射来自数据请求、自定义变量或其他源的数据来动态生成选项。
配置选项
在组件的选项配置中选择「手动创建」模式,此模式适用于包含一下内容的列表:
- 数量较少且可维护的选项
- 静态的选项
- 仅由一个组件使用的选项
250px|700px|reset
映射数据
在选项模式中选择「映射数据」模式,以从数据源生成选项。这类似于在数组上使用方法:数据源中的每个项目都映射到每个选项。此模式最适合包含一下内容的列表:
- 大量的选择
- 具有动态数据源(例如来自API、数据库、或者data对象的元数据、全局选项)的选项
- 多个组件使用的选项
选择数据源
在数据源设置中指定数据源,可以选择一个来自数据请求、自定义变量等的数据源,也可以切换到JS模式提供数组或数组对象。
250px|700px|reset
配置映射
在组件上,我们提供了智能映射,会根据数据源中的key自动映射成选项,映射逻辑如下:
- 字段列表:遍历数据源前10条数据,取字段并集
- 智能映射只能映射符合格式要求的字段
- 选项值映射:支持自动匹配含id、value、name的字段,优先级:
- value > 含value的字段 > id > 含id的字段 > name > 含name的字段;
- 如果存在多个含id、value或name的字段,取第一个映射为选项值
- 如果没有符合上述要求的key,则会自动将 { { i } } 作为选项值
- 选项标题映射:支持自动匹配含name、title、label的字段,优先级:
- label > 含lable的字段 > label字段是个json,其中有个字段是cn > name > 含name的字段 > title > 含title的字段;
- 如果存在多个含label、title或name的字段,取第一个映射为选项标题
- 选项说明:支持自动匹配含caption的字段,优先级:
- caption> 含caption的字段;
- 如果存在多个含caption的字段,取第一个映射为选项说明
- 选项颜色:支持自动匹配含color的字段,优先级:
- color > 含color的字段;
- 如果存在多个含color的字段,取第一个映射为选项颜色
- 选项禁用:支持自动匹配含disable的字段,优先级:
- disable > 含disable的字段;
- 如果存在多个含disable的字段,取第一个映射为选项禁用
- 选项隐藏:支持自动匹配含hidden的字段,优先级:
- hidden > 含hidden的字段;
- 如果存在多个含hidden的字段,取第一个映射为选项隐藏
- 子节点映射:支持自动匹配含children的字段,优先级
- children > 含children的字段;
- 如果存在多个含children的字段,取第一个映射为子节点
- 如果没有符合上述规则字段的配置项,则默认为空
以下提供部分示例供参考: