微信小程序如何自定义分享卡片文案和图片

碧水逍遥2023-08-10 16:59

微信小程序提供了onShareAppMessage方法，专门用来监听用户点击页面内转发按钮（button 组件 open-type="share"）或右上角菜单"转发"按钮的行为，并自定义转发内容。

> 注意：只有定义了此事件处理函数，右上角菜单才会显示"转发"按钮

参数	类型	说明	最低版本
from	String	转发事件来源。 `button`：页面内转发按钮； `menu`：右上角转发菜单	1.2.4
target	Object	如果 `from` 值是 `button`，则 `target` 是触发这次转发事件的 `button`，否则为 `undefined`	1.2.4
webViewUrl	String	页面中包含web-view组件时，返回当前web-view的url	1.6.4

此事件处理函数需要 return 一个 Object，用于自定义转发内容，返回内容如下：

自定义转发内容 基础库 2.8.1 起，分享图支持云图片。

字段	说明	默认值	最低版本
title	转发标题	当前小程序名称
path	转发路径	当前页面 path ，必须是以 / 开头的完整路径
imageUrl	自定义图片路径，可以是本地文件路径、代码包文件路径或者网络图片路径。支持PNG及JPG。显示图片长宽比是 5:4。	使用默认截图	1.5.0
promise	如果该参数存在，则以 resolve 结果为准，如果三秒内不 resolve，分享会使用上面传入的默认参数		2.12.0

示例代码

PS：卡片图片imageUrl可以是本地的，也可以服务器上传的url

复制代码

onShareAppMessage() {
    return {
        title: '分享出去的卡片标题',
        path: '/index/index?id=123',
        imageUrl: '/img/bg.jpg'
    }
}

如果要禁止当前页面的小程序卡片分享，则可以在onLoad中通过以下方式：

wx.hideShareMenu()