Skip to main content
Version: 3.x

OfficialAccount

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

Tips 使用组件前,需前往小程序后台,在“设置”->“关注公众号”中设置要展示的公众号。注:设置的公众号需与小程序主体一致。

在一个小程序的生命周期内,只有从以下场景进入小程序,才具有展示引导关注公众号组件的能力:

当小程序从扫小程序码场景(场景值1047,场景值1124)打开时 当小程序从聊天顶部场景(场景值1089)中的「最近使用」内打开时,若小程序之前未被销毁,则该组件保持上一次打开小程序时的状态 当从其他小程序返回小程序(场景值1038)时,若小程序之前未被销毁,则该组件保持上一次打开小程序时的状态 为便于开发者调试,基础库 2.7.3 版本起开发版小程序增加以下场景展示公众号组件:

开发版小程序从扫二维码(场景值 1011)打开 — 体验版小程序打开 组件限定最小宽度为 300px,高度为定值 84px。

每个页面只能配置一个该组件。

参考文档

类型#

ComponentType<OfficialAccountProps>

OfficialAccountProps#

参数类型必填说明
onLoadBaseEventOrigFunction<detail>组件加载成功时触发
onErrorBaseEventOrigFunction<detail>组件加载失败时触发

API 支持度#

API微信小程序H5React Native
OfficialAccountProps.onLoad✔️
OfficialAccountProps.onError✔️

detail#

detail 对象

参数类型说明
statusnumber状态码
errMsgstring错误信息

status#

status 有效值

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

API 支持度#

API微信小程序H5React Native
OfficialAccount✔️