微信小程序 开放能力 组件

Posted 2021-06-28 java1234_小锋

完整微信小程序(Java后端) 技术贴目录清单页面（必看）

开放能力组件大多为新增组件,且使用频率较低,属于相对比较冷门的组件。可以先简单了解一下。

4.8.1 open-data 开发数据

用于展示微信开放的数据。

小程序插件中不能使用。

属性	类型	默认值	必填	说明	最低版本
type	string		否	开放数据类型	1.4.0
open-gid	string		否	当 type=“groupName” 时生效, 群id	1.4.0
lang	string	en	否	当 type=“user*” 时生效，以哪种语言展示 userInfo	1.4.0
default-text	string		否	数据为空时的默认文案	2.8.1
default-avatar	string		否	用户头像为空时的默认图片，支持相对路径和网络图片路径	2.8.1
binderror	eventhandle		否	群名称或用户信息为空时触发	2.8.1

type 的合法值

值	说明	最低版本
groupName	拉取群名称	1.4.0
userNickName	用户昵称	1.9.90
userAvatarUrl	用户头像	1.9.90
userGender	用户性别	1.9.90
userCity	用户所在城市	1.9.90
userProvince	用户所在省份	1.9.90
userCountry	用户所在国家	1.9.90
userLanguage	用户的语言	1.9.90

lang 的合法值

值	说明	最低版本
en	英文
zh_CN	简体中文
zh_TW	繁体中文

Bug & Tip

1. tip：只有当前用户在此群内才能拉取到群名称
2. tip：关于open-gid的获取请使用 wx.getShareInfo

示例代码

在开发者工具中预览效果

index.wxml

<open-data type="groupName" open-gid="xxxxxx"></open-data>
<open-data type="userAvatarUrl"></open-data>
<open-data type="userGender" lang="zh_CN"></open-data>
<open-data type="userCity"></open-data>

运行效果：

4.8.2 web-view 网页容器

承载网页的容器。会自动铺满整个小程序页面，个人类型的小程序暂不支持使用。

客户端 6.7.2 版本开始，navigationStyle: custom 对 web-view 组件无效

小程序插件中不能使用。

属性	类型	默认值	必填	说明	最低版本
src	string		否	webview 指向网页的链接。可打开关联的公众号的文章，其它网页需登录小程序管理后台配置业务域名。	1.6.4
bindmessage	eventhandler		否	网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data是多次 postMessage 的参数组成的数组	1.6.4
bindload	eventhandler		否	网页加载成功时候触发此事件。e.detail = { src }	1.6.4
binderror	eventhandler		否	网页加载失败的时候触发此事件。e.detail = { src }	1.6.4

示例代码

<view class="page-body">
  <view class="page-section page-section-gap">
    <web-view src="https://mp.weixin.qq.com/"></web-view>
  </view>
</view>

运行效果：

4.8.3 ad 广告

Banner 广告。

属性	类型	默认值	必填	说明	最低版本
unit-id	string		是	广告单元id，可在小程序管理后台的流量主模块新建	1.9.94
ad-intervals	number		否	广告自动刷新的间隔时间，单位为秒，参数值必须大于等于30（该参数不传入时 Banner 广告不会自动刷新）	2.3.1
ad-type	string	banner	否	广告类型，默认为展示banner，可通过设置该属性为video展示视频广告, grid为格子广告	2.8.0
ad-theme	string	white	否		2.8.0
bindload	eventhandle		否	广告加载成功的回调	2.2.1
binderror	eventhandle		否	广告加载失败的回调，event.detail = {errCode: 1002}	2.2.1
bindclose	eventhandle		否	广告关闭的回调	2.6.5

错误码信息与解决方案表

错误码是通过binderror回调获取到的错误信息。

代码	异常情况	理由	解决方案
1000	后端错误调用失败	该项错误不是开发者的异常情况	一般情况下忽略一段时间即可恢复。
1001	参数错误	使用方法错误	可以前往developers.weixin.qq.com确认具体教程（小程序和小游戏分别有各自的教程，可以在顶部选项中，“设计”一栏的右侧进行切换。
1002	广告单元无效	可能是拼写错误、或者误用了其他APP的广告ID	请重新前往mp.weixin.qq.com确认广告位ID。
1003	内部错误	该项错误不是开发者的异常情况	一般情况下忽略一段时间即可恢复。
1004	无适合的广告	广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告	属于正常情况，且开发者需要针对这种情况做形态上的兼容。
1005	广告组件审核中	你的广告正在被审核，无法展现广告	请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。
1006	广告组件被驳回	你的广告审核失败，无法展现广告	请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。
1007	广告组件被驳回	你的广告能力已经被封禁，封禁期间无法展现广告	请前往mp.weixin.qq.com确认小程序广告封禁状态。
1008	广告单元已关闭	该广告位的广告能力已经被关闭	请前往mp.weixin.qq.com重新打开对应广告位的展现。

Bug & Tip

1. tip：在无广告展示时，ad 标签不会占用高度
2. tip：ad 组件不支持触发 bindtap 等触摸相关事件
3. tip：目前可以给 ad 标签设置 wxss 样式调整广告宽度，以使广告与页面更融洽，但请遵循小程序流量主应用规范
4. tip：监听到error回调后，开发者可以针对性的处理，比如隐藏广告组件的父容器，以保证用户体验，但不要移除广告组件，否则将无法收到bindload的回调。

4.8.4 ad-custom 原生模板广告

基础库 2.10.4 开始支持，低版本需做兼容处理。

原生模板 广告。

属性	类型	默认值	必填	说明	最低版本
unit-id	string		是	广告单元id，可在小程序管理后台的流量主模块新建	2.10.4
ad-intervals	number		否	广告自动刷新的间隔时间，单位为秒，参数值必须大于等于30（该参数不传入时 模板 广告不会自动刷新）	2.10.4
bindload	eventhandle		否	广告加载成功的回调	2.10.4
binderror	eventhandle		否	广告加载失败的回调，event.detail = {errCode: 1002}	2.10.4

错误码信息与解决方案表

错误码是通过binderror回调获取到的错误信息。

代码	异常情况	理由	解决方案
1000	后端错误调用失败	该项错误不是开发者的异常情况	一般情况下忽略一段时间即可恢复。
1001	参数错误	使用方法错误	可以前往developers.weixin.qq.com确认具体教程（小程序和小游戏分别有各自的教程，可以在顶部选项中，“设计”一栏的右侧进行切换。
1002	广告单元无效	可能是拼写错误、或者误用了其他APP的广告ID	请重新前往mp.weixin.qq.com确认广告位ID。
1003	内部错误	该项错误不是开发者的异常情况	一般情况下忽略一段时间即可恢复。
1004	无适合的广告	广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告	属于正常情况，且开发者需要针对这种情况做形态上的兼容。
1005	广告组件审核中	你的广告正在被审核，无法展现广告	请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。
1006	广告组件被驳回	你的广告审核失败，无法展现广告	请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。
1007	广告组件被驳回	你的广告能力已经被封禁，封禁期间无法展现广告	请前往mp.weixin.qq.com确认小程序广告封禁状态。
1008	广告单元已关闭	该广告位的广告能力已经被关闭	请前往mp.weixin.qq.com重新打开对应广告位的展现。

Bug & Tip

1. tip：在无广告展示时，ad-custom 标签不会占用高度
2. tip：ad-custom 组件不支持触发 bindtap 等触摸相关事件
3. tip：目前可以给 ad-custom 标签设置 wxss 样式调整广告宽度，以使广告与页面更融洽，但请遵循小程序流量主应用规范
4. tip：监听到error回调后，开发者可以针对性的处理，比如隐藏广告组件的父容器，以保证用户体验，但不要移除广告组件，否则将无法收到bindload的回调
5. tip：不同模板涉及一些不同的使用场景，具体方式请参考模板编辑器

4.8.5 official-account 公众号关注

基础库 2.3.0 开始支持，低版本需做兼容处理。

公众号关注组件。当用户扫小程序码打开小程序时，开发者可在小程序内配置公众号关注组件，方便用户快捷关注公众号，可嵌套在原生组件内。

Tips

1. 使用组件前，需前往小程序后台，在“设置”->“关注公众号”中设置要展示的公众号。注：设置的公众号需与小程序主体一致。
2. 在一个小程序的生命周期内，只有从以下场景进入小程序，才具有展示引导关注公众号组件的能力:
   • 当小程序从扫小程序码场景（场景值1047，场景值1124）打开时
   • 当小程序从聊天顶部场景（场景值1089）中的「最近使用」内打开时，若小程序之前未被销毁，则该组件保持上一次打开小程序时的状态
   • 当从其他小程序返回小程序（场景值1038）时，若小程序之前未被销毁，则该组件保持上一次打开小程序时的状态
3. 为便于开发者调试，基础库 2.7.3 版本起开发版小程序增加以下场景展示公众号组件：
   • 开发版小程序从扫二维码（场景值 1011）打开 — 体验版小程序打开
4. 组件限定最小宽度为300px，高度为定值84px。
5. 每个页面只能配置一个该组件。

属性名	类型	说明
bindload	EventHandle	组件加载成功时触发
binderror	EventHandle	组件加载失败时触发

detail 对象

属性名	类型	说明
status	Number	状态码
errMsg	String	错误信息

status 有效值

值	说明
-2	网络错误
-1	数据解析错误
0	加载成功
1	小程序关注公众号功能被封禁
2	关联公众号被封禁
3	关联关系解除或未选中关联公众号
4	未开启关注公众号功能
5	场景值错误
6	重复创建

示例代码

<official-account></official-account>

微信搜一搜【java1234】关注这个放荡不羁的程序员，关注后回复【资料】有我准备的一线大厂笔试面试资料以及简历模板。