弹出列表
约 806 字大约 3 分钟
2025-04-17
在线预览
参数配置
读取数据所存储的字段名
说明
模型字段如果有关联,会自动生成 relationname
的配置。没有配置该值的话直接读取当前dataIndex字段的值。
比如关联了user,后台数据 with->(['user'])
后数据默认去读取当前 record.user
中的 fieldNames
{
"fieldProps":{
"relationname":"user"
}
}
size
配置选择后的数据展示框的大小,最大为100%宽度,不会超过父容器宽度。
{
"fieldProps":{
"size":"small | default | large"
}
}
fieldNames
自定义显示字段信息 有 avatar图片,title标题,description描述字段,默认字段名
{
"fieldProps":{
"fieldNames":{
"title": "标题字段 默认 title",
"description": "描述字段 默认 desc",
"avatar": "头像字段 默认 ['titlepic', 0, 'url'] 支持数组模式手动指定对象中的字段,如果是字符串会默认读取 字段.0.url"
}
}
}
关联菜单选择
说明
直接在配置关联页面中选择已有的菜单,也可以手动配置 fieldProps.page.path 关联页面路径。建议直接选择关联页面。
弹层页面列表项
说明
如果不配置默认就是直接使用关联页面的列表项,如果配置了则使用配置的列表项。如果关联页面没有其它地方展示,只是作为数据源来选取,那么配置好关联页面后,这里就不用在自定义列了。
{
"fieldProps":{
"page": {
"columns": [//弹层需要展示的列字段集合,如果设置按照设置的显示,未设置则使用关联页面的列表列显示
],
"path":"关联的页面路径,如果设置了模型关联会自动生成,或在编辑项中选择关联页面指定的菜单"
},
}
}
提交数据字段
说明
默认只会提交 id
和 fieldNames
中的字段。如果想在提交数据中增加数据的其它字段需要配置 fieldProps.extColumns
字段。
这样表单提交后会包含这些额外的字段信息,后端可以获取到。
主要是获取记录的全部字段信息,如果record的数据量很大的话,那么post的数据也将会很大
{
"fieldProps":{
"extColumns":["字段1","字段2"]//提交数据中增加的字段
}
}
多选
说明
配置字段为 modalSelects后,在详情页面会通过关联的名称把数据读取出返回前端。关联的类型请选择cascaders
还需要手动配置 fieldNames
,如果显示的字段名称和默认不一致的话
多选时数据放到了[{data:record}]data中。data名称可以配置{dataName:"data"},如果是通过模型字段自动配置的,就默认为data不能再修改了
{
"fieldProps":{
"multiple":true,//是否开启多选
"max":9,//最大选择数量
}
}
使用示例配置
{
"fieldNames": {
"title": "username",
"description": "desc",
"avatar": "avatar"
},
"page": {
"columns": [
"username",
"avatar",
"desc",
"keyword"
]
}
}