# official-account
基础库 2.3.0 开始支持,低版本需做兼容处理。
微信 Mac 版:支持
渲染框架支持情况:Skyline (使用最新 Nighly 工具调试)、WebView
# 功能描述
公众号关注组件。当用户扫小程序码打开小程序时,开发者可在小程序内配置公众号关注组件,方便用户快捷关注公众号,可嵌套在原生组件内。
基础库 2.18.1
起,公众号关注组件显示场景值变更如下:
小程序场景值命中以下值时,可展示关注公众号组件:
- 1011 扫描二维码
- 1017 前往小程序体验版的入口页
- 1025 扫描一维码
- 1047 扫描小程序码
- 1124 扫“一物一码”打开小程序
小程序热启动场景值命中以下值时,冷启动场景值在【1011、1017、1025、1047、1124】中,可展示关注公众号组件:
- 1001 发现栏小程序主入口,「最近使用」列表
- 1038 从另一个小程序返回
- 1041 从插件小程序返回小程序
- 1089 微信聊天主界面下拉,「最近使用」栏
- 1090 长按小程序右上角菜单唤出最近使用历史
- 1104 微信聊天主界面下拉,「我的小程序」栏
- 1131 浮窗
- 1187 新版浮窗,微信8.0起
# Tips
使用组件前,需前往小程序后台,在“设置”->“关注公众号”中设置要展示的公众号。注:设置的公众号需与小程序为同主体或关联主体。
在一个小程序的生命周期内,只有从以下场景进入小程序,才具有展示引导关注公众号组件的能力:
- 当小程序从扫小程序码场景(场景值1047,场景值1124)打开时
- 当小程序从聊天顶部场景(场景值1089)中的「最近使用」内打开时,若小程序之前未被销毁,则该组件保持上一次打开小程序时的状态
- 当从其他小程序返回小程序(场景值1038)时,若小程序之前未被销毁,则该组件保持上一次打开小程序时的状态
为便于开发者调试,基础库
2.7.3
版本起开发版小程序增加以下场景展示公众号组件:- 开发版小程序从扫二维码(场景值 1011)打开 — 体验版小程序打开
组件限定最小宽度为300px,高度为定值84px。
每个页面只能配置一个该组件。
属性名 | 类型 | 说明 |
---|---|---|
bindload | EventHandle | 组件加载成功时触发 |
binderror | EventHandle | 组件加载失败时触发 |
# detail 对象
属性名 | 类型 | 说明 |
---|---|---|
status | Number | 状态码 |
errMsg | String | 错误信息 |
# status 有效值
值 | 说明 |
---|---|
-2 | 网络错误 |
-1 | 数据解析错误 |
0 | 加载成功 |
1 | 小程序关注公众号功能被封禁 |
2 | 关联公众号被封禁 |
3 | 关联关系解除或未选中关联公众号 |
4 | 未开启关注公众号功能 |
5 | 场景值错误 |
6 | 重复创建 |
# 示例代码
<official-account></official-account>