# official-account-publish
基础库 3.9.3 开始支持,低版本需做兼容处理。
渲染框架支持情况:WebView
# 功能描述
公众号图文组件。
公众号图文组件为小程序开发者提供了在小程序里直接发表和消费公众号图文的能力。 该组件可以帮助开发者实现社区讨论、用户交流的功能,并且能借助公众号平台让更多人通过图文发现小程序。
# 话题定制
图文组件上会展示话题名称,用户从组件发表时也会默认带上对应的#话题。默认使用小程序名称作为话题,开发者也可通过topic
参数自定义,最多20字。
# 内容展示
- 组件里会展示从该组件发表的所有图文(如果一个小程序里有多个同话题名称的组件,其下的图文也会互通展示)。
- 通过
limit
参数控制最多展示的图文数量,上限10条。 - 当组件下内容为空时,默认显示“来写下第一条吧”,可通过
placeholder
参数自定义文案,最多显示一行。
# 跳转设置
用户从该组件发表的图文,会在文末展示“来自小程序xxx”,点击后默认跳转首页,可通过weapp-path
参数指定跳转路径。
# 内容管理
- 可以前往小程序后台对单条图文进行置顶或拉黑(路径:开发管理 → 接口设置 → 接口权限 → 其它组件 → 公众号图文)。
- 同一个话题下最多置顶3条图文。
- 小程序后台支持查看每个组件下的基础数据。
# 属性说明
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
topic | string | 否 | 话题名称,最多20字,默认使用小程序名称 | 3.9.3 | |
limit | number | 5 | 否 | 小程序页面内最多展示的图文数量,超出后剩余的图文需要点击「查看更多」前往查看 | 3.10.3 |
weapp-path | string | 否 | 发表图文后,点击来源小程序跳转的页面 | 3.9.3 | |
background-color | color | #f7f7f7 | 否 | 图文组件的背景颜色 | 3.9.3 |
color-unity | boolean | false | 否 | 是否需要色彩统一,话题名称颜色和图文卡片背景颜色是否对齐 | 3.9.3 |
placeholder | string | 来写下第一条吧 | 否 | 无内容时的占位文案 | 3.10.2 |
binderror | eventhandle | 否 | 列表拉取失败时触发 | 3.9.3 | |
bindempty | eventhandle | 否 | 列表拉取为空时触发 | 3.9.3 |
# Bug & Tip
tip
:暂不支持在微信 Windows 版、微信 Mac 版及微信鸿蒙版本的小程序上显示发表按钮。tip
:话题名称要求不超过20字,超过将不展示该组件。
# 示例代码
<official-account-publish topic="和coco一起做好事"></official-account-publish>