# official-account

> 基础库 2.3.0 开始支持，低版本需做[兼容处理](1003706)。

> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

渲染框架支持情况：Skyline （使用最新 [Nightly](/miniprogram/dev/devtools/nightly.html) 工具调试）、WebView

## 功能描述

公众号关注组件。当用户扫[小程序码](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/qr-code.html?t=19032815)打开小程序时，开发者可在小程序内配置公众号关注组件，方便用户快捷关注公众号，可嵌套在原生组件内。

基础库 `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. 每个页面只能配置一个该组件。

| 属性名    | 类型        | 说明               |
| --------- | ----------- | ------------------ |
| bind:load  | EventHandle | 组件加载成功时触发 |
| bind:error | EventHandle | 组件加载失败时触发 |

### detail 对象
| 属性名 | 类型   | 说明     |
| ------ | ------ | -------- |
| status | Number | 状态码   |
| errMsg | String | 错误信息 |

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

## 示例代码

```html
<official-account></official-account>
```