微信小程序插件
添加插件
在使用插件前,首先要在小程序管理后台的“设置 - 第三方服务 - 插件管理”中添加插件 海报云服务。插件无需申请,添加后可直接使用。
注意事项
- 请确保调试基础库不低于
2.11.2
版本 - 请勿开启
上传时进行代码保护
引入插件
使用插件前,使用者要在 app.json
中声明需要使用的插件,例如:
json
{
"plugins": {
"fp-plugin": {
"version": "1.1.0",
"provider": "wx6ee6a1591aa18696",
"export": "fastposter.js"
}
}
}
{
"plugins": {
"fp-plugin": {
"version": "1.1.0",
"provider": "wx6ee6a1591aa18696",
"export": "fastposter.js"
}
}
}
使用插件
使用插件提供的自定义组件,和 使用普通自定义组件 的方式相仿。在 json
文件定义需要引入的自定义组件时,使用 plugin://
协议指明插件的引用名和自定义组件名,例如:
json
{
"usingComponents": {
"fastposter": "plugin://fp-plugin/fastposter"
}
}
{
"usingComponents": {
"fastposter": "plugin://fp-plugin/fastposter"
}
}
在wxml中使用,例如:
xml
<fastposter class="img" mode="aspectFit" token="xxx" uuid="xxxx" payload="{{ items }}" />
<fastposter class="img" mode="aspectFit" token="xxx" uuid="xxxx" payload="{{ items }}" />
组件属性
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
token | string | 无 | 是 | 应用token |
uuid | string | 无 | 是 | 海报的uuid |
payload | object | 无 | 是 | 海报动态参数,以对象形式传入 |
class | object | 无 | 是 | 通过设置class 可以用来约束图片的大小等css样式属性 |
mode | string | scaleToFill | 否 | 图片裁剪、缩放的模式,具体查看 |
lazy-load | boolean | false | 否 | 图片懒加载,在即将进入一定范围(上下三屏)时才开始加载 |
show-menu-by-longpress | boolean | false | 否 | 长按图片显示发送给朋友、收藏、保存图片、搜一搜、打开名片/前往群聊/打开小程序(若图片中包含对应二维码或小程序码)的菜单。 |
binderror | eventhandle | 无 | 否 | 当错误发生时触发,event.detail = {errMsg} |
bindload | eventhandle | 无 | 否 | 当图片载入完毕时触发,event.detail = {height, width} |