简体中文
list.render.before
约 560 字大约 2 分钟
2025-11-24
列表页渲染之前触发,此时已经取到对象布局描述数据。
- 更改布局描述数据
- 更改标题
参数
| 参数 | 说明 | 类型 |
|---|---|---|
| listHeaderRst | ListHeader接口返回值,插件中可直接修改 | Object |
返回结果
| 参数 | 说明 | 类型 |
|---|---|---|
| title | 返回修改后的标题,为空使用默认标题 | String |
| handleButtons | 列表通用按钮(右下角的悬浮按钮)加工函数 | Function |
| refreshUiWhenAfterSearch | 从搜索返回后,触发列表数据UI刷新 | Boolean |
| fixedComponents | 注册弹窗类组件 | Array |
| defaultSelectTab | 指定默认选中列表(选择列表专属) , geo: 附近列表 ,默认全部列表 | String |
| cssMap | 列表css样式定制集合,详细说明见下文 | Map |
cssMap
| 样式key | 说明 | 类型 |
|---|
代码示例
修改标题栏的文案
{
event: "list.render.before",
functional: function (pluginExecResult, options) {
return {
title: "插件修改后的标题",//返回修改后的标题,为空使用默认标题
}
}
}加工列表通用按钮
增删通用按钮
{
event: "list.render.before",
functional: function (pluginExecResult, options) {
return {
handleButtons(opt){
opt.buttons.push({//追加通用按钮
action: "test",
icon: "guanlianCRMduixiang",
onClick:()=>{
wx.showToast({title:"插件测试"})
}
})
let delIndex = opt.buttons.findIndex(it=>it.action==='Add');//找到Add按钮
opt.buttons.splice(delIndex, 1);//删除按钮
return opt
},
}
}
}新建按钮配置选择业务类型白名单/黑名单
{
event: "list.render.before",
functional: function (pluginExecResult, options) {
return {
handleButtons(opt){
opt.buttons.forEach(it=>{
if (it.action === 'Add'){//找到新建按钮
it.recordTypeWhiteList = ['default__c', 'record_cF1aO__c'];//指定新建对象业务类型白名单
it.recordTypeBlackList = ['record_cF1aO__c'];//指定新建对象业务类型黑名单
}
})
return opt
},
}
}
}插件内实现的弹窗组件
自定义插件定义
{
event: "form.render.before",
functional: function (pluginExecResult, options) {
return {
handleButtons(opt){//追加通用按钮
opt.buttons.push({
action: "test",//按钮唯一标识
icon: "guanlianCRMduixiang",//图标
label:"插件测试",
onClick:()=>{
//发送 show-dialog1 事件,触发dialog1展示(监听见:./components/dialog1/index#attached)
self.context.emitEvent("show-dialog1",{showOptionTest:1})
}
})
return opt
},
fixedComponents: [{
resource: "custom_plugin",//必须,固定写死
prop:{//必须,插件组件基本属性
pluginInfo:self.pluginParam.describe,//必须,插件基本信息
comInfo:{//必须,插件组件信息
name: "dialog1",//必须,自定义组件的名称,根目录config.json文件中components节点中指向对应组件的key
prop: {test: 1},//自定义组件属性,会透传到自定义组件customProp属性,格式不限
}
}
}]
}
}
}