公众号关注组件。当用户扫小程序码打开小程序时,开发者可在小程序内配置公众号关注组件,方便用户快捷关注公众号,可嵌套在原生组件内。
Tips 使用组件前,需前往小程序后台,在“设置”->“关注公众号”中设置要展示的公众号。注:设置的公众号需与小程序主体一致。
在一个小程序的生命周期内,只有从以下场景进入小程序,才具有展示引导关注公众号组件的能力:
当小程序从扫小程序码场景(场景值1047,场景值1124)打开时 当小程序从聊天顶部场景(场景值1089)中的「最近使用」内打开时,若小程序之前未被销毁,则该组件保持上一次打开小程序时的状态 当从其他小程序返回小程序(场景值1038)时,若小程序之前未被销毁,则该组件保持上一次打开小程序时的状态 为便于开发者调试,基础库 2.7.3 版本起开发版小程序增加以下场景展示公众号组件:
开发版小程序从扫二维码(场景值 1011)打开 — 体验版小程序打开 组件限定最小宽度为 300px,高度为定值 84px。
每个页面只能配置一个该组件。
类型
ComponentType<OfficialAccountProps>
OfficialAccountProps
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
onLoad | BaseEventOrigFunction<detail> | 否 | 组件加载成功时触发 |
onError | BaseEventOrigFunction<detail> | 否 | 组件加载失败时触发 |
API 支持度
API | 微信小程序 | H5 | React Native |
---|---|---|---|
OfficialAccountProps.onLoad | |||
OfficialAccountProps.onError |
detail
detail 对象
参数 | 类型 | 说明 |
---|---|---|
status | number | 状态码 |
errMsg | string | 错误信息 |
status
status 有效值
参数 | 说明 |
---|---|
-2 | 网络错误 |
-1 | 数据解析错误 |
0 | 加载成功 |
1 | 小程序关注公众号功能被封禁 |
2 | 关联公众号被封禁 |
3 | 关联关系解除或未选中关联公众号 |
4 | 未开启关注公众号功能 |
5 | 场景值错误 |
6 | 重复创建 |
API 支持度
API | 微信小程序 | H5 | React Native |
---|---|---|---|
OfficialAccount |