.. _offical-account:

:wx_comp:`official-account`
===========================

.. versionadded:: 2.3.0  低版本需做 :ref:`compatibility` 。

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

.. tip::

   1. 使用组件前，需前往小程序后台，在“设置”->“接口设置”->“公众号关注组件”中设置要展示的公众号。注：设置的公众号需与小程序主体一致。
   2. 在一个小程序的生命周期内，只有从以下场景进入小程序，才具有展示引导关注公众号组件的能力:

     - 当小程序从扫小程序码场景（场景值1047）打开时
     - 当小程序从聊天顶部场景（场景值1089）中的「最近使用」内打开时，若小程序之前未被销毁，则该组件保持上一次打开小程序时的状态
     - 当从其他小程序返回小程序（场景值1038）时，若小程序之前未被销毁，则该组件保持上一次打开小程序时的状态

   3. 组件限定最小宽度为300px，高度为定值84px。
   4. 每个页面只能配置一个该组件。

+-----------+-------------+--------------------+
|  属性名   |    类型     |        说明        |
+===========+=============+====================+
| bindload  | EventHandle | 组件加载成功时触发 |
+-----------+-------------+--------------------+
| binderror | EventHandle | 组件加载失败时触发 |
+-----------+-------------+--------------------+

detail 对象

+--------+--------+----------+
| 属性名 |  类型  |   说明   |
+========+========+==========+
| status | Number | 状态码   |
+--------+--------+----------+
| errMsg | String | 错误信息 |
+--------+--------+----------+

status  有效值

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

示例代码

.. code:: html

  <official-account></official-account>