开发小程序自定义插件
# 开发第一个小程序自定义插件
小程序自定义插件采用 小程序 框架,如果您:
有小程序开发经验,可以直接上手开发小程序自定义插件。
没有使用过小程序,建议先简单学习一下 小程序开发文档:
看一个最简单的示例(新建编辑页插件)
# 第一步:我们下载小程序的(模板 (opens new window)),代码如下:
修改下列文件:
- 配置文件,声明插件的入口文件
{
"components":{},
"main":"index.js"
}
- 插件代码:
/**插件初始化函数*/
module.exports = function (context) {
//返回钩子集合对象
return {
/**获取标题*/
getTitle({title, isEdit}){
//参数中的title为默认标题
return isEdit ? "自定义标题-编辑" : "自定义标题-新建";//插件中自定义标题栏文案
}
}
}
# 第二步:压缩文件
注意,解压的文件结构,解压后直接是小程序依赖的各个文件,并非是一个文件夹。
ps: 若上传压缩包报错,可使用压缩工具进行压缩上传(常见于mac,使用mac自带压缩会报错)
# 第三步:找到管理后台的「自定义插件」管理界面,点击「新建」并上传该文件
新建插件时,选择组件类型为 新建编辑页JS插件
,支持终端为 移动端
。
# 第四步:在表单布局设计器中,找到「全局设置」中的「移动端新建编辑页JS插件」,选择刚才新创建的插件并保存
# 第五步:打开纷享销客app,新建对象时查看该插件是否生效。
效果:标题栏展示了插件中自定义的文案
# 插件代码结构说明
- 根目录下必须有config.json (必须)
- components:注册需要暴露给插件使用方的组件,key为组件名称,value为组件的相对路径;一些插件+ 内部子组件无需注册;
- main:插件入口js文件相对路径
- 项目下的js文件及组件定义参照微信规范,没有额外限制