1、分享的代码
//按钮分享
onShareAppMessage: function(res) {
if (res.from === 'button') {
return {
title: '开发学习测试中',
path: '/pages/index/index',
success: function(res) {
console.log('成功', res)
}
}
}
//右上角分享
if (res.from === 'menu') {
return {
title: '右上角分享按钮',
path: '/pages/index/index',
success: function(res) {
console.log('成功', res)
}
}
}
2、API
获取更多转发信息
通常开发者希望转发出去的小程序被二次打开的时候能够获取到一些信息,例如群的标识。现在通过调用 wx.showShareMenu
并且设置 withShareTicket
为 true
,当用户将小程序转发到任一群聊之后,此转发卡片在群聊中被其他用户打开时,可以在 App.onLaunch 或 App.onShow 获取到一个 shareTicket
。通过调用 wx.getShareInfo() 接口传入此 shareTicket
可以获取到转发信息。
页面内发起转发
基础库 1.2.0 开始支持,低版本需做兼容处理。
通过给 button
组件设置属性 open-type="share"
,可以在用户点击按钮后触发 Page.onShareAppMessage
事件,如果当前页面没有定义此事件,则点击后无效果。相关组件:button
onShareAppMessage(Object)
监听用户点击页面内转发按钮(<button>
组件 open-type="share"
)或右上角菜单“转发”按钮的行为,并自定义转发内容。
注意:只有定义了此事件处理函数,右上角菜单才会显示“转发”按钮
Object 参数说明:
参数 | 类型 | 说明 | 最低版本 |
---|---|---|---|
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,用于自定义转发内容,返回内容如下:
自定义转发内容
字段 | 说明 | 默认值 | 最低版本 |
---|---|---|---|
title | 转发标题 | 当前小程序名称 | |
path | 转发路径 | 当前页面 path ,必须是以 / 开头的完整路径 | |
imageUrl | 自定义图片路径,可以是本地文件路径、代码包文件路径或者网络图片路径。支持PNG及JPG。显示图片长宽比是 5:4。 | 使用默认截图 | 1.5.0 |