Skip to content

微信小程序插件

添加插件

在使用插件前,首先要在小程序管理后台的“设置 - 第三方服务 - 插件管理”中添加插件 海报云服务。插件无需申请,添加后可直接使用。

注意事项

  1. 请确保调试基础库不低于2.11.2版本
  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 }}" />

组件属性

属性类型默认值必填说明
tokenstring应用token
uuidstring海报的uuid
payloadobject海报动态参数,以对象形式传入
classobject通过设置class 可以用来约束图片的大小等css样式属性
modestringscaleToFill图片裁剪、缩放的模式,具体查看
lazy-loadbooleanfalse图片懒加载,在即将进入一定范围(上下三屏)时才开始加载
show-menu-by-longpressbooleanfalse长按图片显示发送给朋友、收藏、保存图片、搜一搜、打开名片/前往群聊/打开小程序(若图片中包含对应二维码或小程序码)的菜单。
binderroreventhandle当错误发生时触发,event.detail = {errMsg}
bindloadeventhandle当图片载入完毕时触发,event.detail = {height, width}