公众号关注组件 (official-account)的使用

公众号关注组件 (official-account)

功能描述

公众号关注组件是微信小程序中的一个组件，允许用户在小程序内方便快捷地关注公众号。开发者可以在小程序后台配置需要展示的公众号。此组件可以嵌套在原生组件内，支持 Skyline 和 WebView 渲染框架。

公众号关注组件为开发者提供了一种便捷的方式在小程序内引导用户关注公众号，增强用户互动和转化。通过合理配置和使用，可以有效提升公众号的关注率和用户粘性。

使用场景

当用户通过以下场景进入小程序时，可以展示公众号关注组件：

• 扫描二维码、小程序码、一维码
• 从微信聊天主界面下拉进入
• 从另一个小程序返回
• 在“最近使用”栏或“我的小程序”栏中打开
• 使用浮窗进入

开发前准备

使用公众号关注组件前，需要在小程序后台的“设置”->“关注公众号”中设置要展示的公众号。注意：设置的公众号需与小程序为同主体或关联主体。

属性和事件

属性

• bindload: 组件加载成功时触发
• binderror: 组件加载失败时触发

detail 对象

detail 对象包含以下属性：

• status (Number): 状态码
• errMsg (String): 错误信息

status 有效值

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

示例代码

<official-account bindload="onLoad" binderror="onError"></official-account>

<script>
Page({
  onLoad: function(e) {
    console.log('公众号组件加载成功');
  },
  onError: function(e) {
    console.error('公众号组件加载失败', e.detail.errMsg);
  }
});
</script>

注意事项

• 每个页面只能配置一个公众号关注组件。
• 组件限定最小宽度为 300px，高度为 84px。

参考文档

更多详细信息请参考微信开发者文档。