选项配置|飞书低代码平台

选项配置|飞书低代码平台

飞书低代码平台手册精选NaN-NaN-NaN
产品功能
功能说明
许多组件都会显示选项列表,如下拉单选、下拉多选、级联单选等。每个选项包含许多设置,具体取决于组件(如value、label等等)
一些组件允许您手动配置每个选项,或者通过映射来自数据请求、自定义变量或其他源的数据来动态生成选项。
配置选项
在组件的选项配置中选择「手动创建」模式,此模式适用于包含一下内容的列表:
  • 数量较少且可维护的选项
  • 静态的选项
  • 仅由一个组件使用的选项
250px|700px|reset
映射数据
在选项模式中选择「映射数据」模式,以从数据源生成选项。这类似于在数组上使用方法:数据源中的每个项目都映射到每个选项。此模式最适合包含一下内容的列表:
  • 大量的选择
  • 具有动态数据源(例如来自API、数据库、或者data对象的元数据、全局选项)的选项
  • 多个组件使用的选项
选择数据源
在数据源设置中指定数据源,可以选择一个来自数据请求、自定义变量等的数据源,也可以切换到JS模式提供数组或数组对象。
250px|700px|reset
配置映射
可以用「item」引用当前数据源项,并用「i」引用当前索引。例如:如果数据源中的项由id,则可以使用 { { item.id } } 来引用它。
在组件上,我们提供了智能映射,会根据数据源中的key自动映射成选项,映射逻辑如下:
  • 字段列表:遍历数据源前10条数据,取字段并集
  • 智能映射只能映射符合格式要求的字段
  • 选项值映射:支持自动匹配含id、value、name的字段,优先级:
  1. value > 含value的字段 > id > 含id的字段 > name > 含name的字段
  1. 如果存在多个含id、value或name的字段,取第一个映射为选项值
  1. 如果没有符合上述要求的key,则会自动将 { { i } } 作为选项值
  • 选项标题映射:支持自动匹配含name、title、label的字段,优先级:
  1. label > 含lable的字段 > label字段是个json,其中有个字段是cn > name > 含name的字段 > title > 含title的字段
  1. 如果存在多个含label、title或name的字段,取第一个映射为选项标题
  • 选项说明:支持自动匹配含caption的字段,优先级:
  1. caption> 含caption的字段
  1. 如果存在多个含caption的字段,取第一个映射为选项说明
  • 选项颜色:支持自动匹配含color的字段,优先级:
  1. color > 含color的字段
  1. 如果存在多个含color的字段,取第一个映射为选项颜色
  • 选项禁用:支持自动匹配含disable的字段,优先级:
  1. disable > 含disable的字段
  1. 如果存在多个含disable的字段,取第一个映射为选项禁用
  • 选项隐藏:支持自动匹配含hidden的字段,优先级:
  1. hidden > 含hidden的字段
  1. 如果存在多个含hidden的字段,取第一个映射为选项隐藏
  • 子节点映射:支持自动匹配含children的字段,优先级
  1. children > 含children的字段
  1. 如果存在多个含children的字段,取第一个映射为子节点
  • 如果没有符合上述规则字段的配置项,则默认为空
以下提供部分示例供参考:
编号
数据源
智能映射结果
说明
1
[
{'other':1,'id':11},
{'other':2,'id':22}
]
选项值:{ { item.id } }
前10条存在id字段,自动映射为选项值
2
[
{'other':1,'value':11},
{'other':2,'value':22}
]
选项值:{ { item.value } }
前10条存在value字段,自动映射为选项值
3
[
{'other':1,'apiName':11},
{'other':2,'apiName':22}
]
选项值:{ { item.apiName } }
选项标题:{ { item.apiName } }
  • 前10条存在id、value的字段avaluee、name的字段apiName,根据value > id >name的优先级,将avaluee自动映射为选项值
  • 前10条存在name的apiName字段,自动映射为选项标题
4
[
{'other':111111,'id':1,'avaluee':11,'apiName':111},
{'other':111111,'id':1,'avaluee':11,'apiName':111},
{'other':222222,'id':2,'value':22,'apiName':222}
]
选项值:{ { item.avaluee } }
选项标题:{ { item.apiName } }
  • 前10条存在id、value的字段avaluee、name的字段apiName,根据value > id >name的优先级,将avaluee自动映射为选项值
  • 前10条存在name的apiName字段,自动映射为选项标题
5
[
{'other':1,'label':11},
{'other':2,'label':22}
]
选项标题:{ { item.label } }
  • 前10条存在label字段,自动映射为选项标题
6
[
{'other':1,'title':11},
{'other':2,'title':22}
]
选项标题:{ { item.title } }
  • 前10条存在title字段,自动映射为选项标题
7
[
{'other':1,'label':1111,'name':11111,'title':111},
{'other':2,'label':2222,'name':22222,'title':222}
]
选项值:{ { item.name } }
选项标题:{ { item.label } }
  • 前10条存在name字段,自动映射为选项值
  • 前10条存在label、name字段,根据优先级label > 含lable的字段 > label字段是个json,其中有个字段是cn > name > 含name的字段 > title > 含title的字段将label自动映射为选项标题
8
[
{'other':1,'label':{'cn':'一',en:'one'},'title':111},
{'other':2,'label':{'cn':'二',en:'two'},'title':222}
]
选项标题:{ { item.label.cn } }
  • name字段是个json,不符合选项值的格式要求,所以不会映射为选项值
  • 前10条存在label字段,其是个json,且其中含有cn字段,将label.cn映射为选项标题
9
[
{'other':1,'avaluee':1111,'value':11111},
{'other':2,'avaluee':2222,'value':22222}
]
选项值:{ { item.value } }
  • 前10条存在value和含value的字段avaluee,根据优先级value > 含value的字段 > id > 含id的字段 > name > 含name的字段,将value字段映射为选项值
10
[
{'other':1,'bvaluee':1111,'avaluee':2222},
{'other':2,'avaluee':2222}
]
选项值:{ { item.bvaluee } }
  • 前10条存在含value的bvaluee字段和avaluee字段,取第一个出现的字段bvaluee映射为选项值
11
[
{'other':111111,'id':1,'avaluee':11},
{'other':222222,'id':2,'avaluee':22},
{'other':222222,'id':2,'avaluee':22},
此处省略「6」条,
{'other':222222,'id':2,'avaluee':22,'value':333}
]
选项值:{ { item.value } }
  • 前10条存在value(在第x条)和含value的字段avaluee,根据优先级value > 含value的字段 > id > 含id的字段 > name > 含name的字段,将value字段映射为选项值
12
[
{'other':111111,'id':1,'avaluee':11},
{'other':222222,'id':2,'avaluee':22},
{'other':222222,'id':2,'avaluee':22},
此处省略「7」条,
{'other':222222,'id':2,'avaluee':22,'value':333}
]
选项值:{ { item.avaluee } }
  • 前10条存在含value的字段avaluee,将avaluee字段映射为选项值(value在第11条)
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
选项配置|飞书低代码平台
先进生产力和业务协同平台
联系我们立即试用
联系我们立即试用