# official-account

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

微信 Mac 版:支持

渲染框架支持情况:WebView

# 功能描述

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

基础库 2.18.1 起,公众号关注组件显示场景值变更如下:

小程序场景值命中以下值时,可展示关注公众号组件:

  1. 1011 扫描二维码
  2. 1017 前往小程序体验版的入口页
  3. 1025 扫描一维码
  4. 1047 扫描小程序码
  5. 1124 扫“一物一码”打开小程序

小程序热启动场景值命中以下值时,冷启动场景值在【1011、1017、1025、1047、1124】中,可展示关注公众号组件:

  1. 1001 发现栏小程序主入口,「最近使用」列表
  2. 1038 从另一个小程序返回
  3. 1041 从插件小程序返回小程序
  4. 1089 微信聊天主界面下拉,「最近使用」栏
  5. 1090 长按小程序右上角菜单唤出最近使用历史
  6. 1104 微信聊天主界面下拉,「我的小程序」栏
  7. 1131 浮窗
  8. 1187 新版浮窗,微信8.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>