页面事件处理函数
onShareAppMessage
解释:在 Page 中定义 onShareAppMessage 函数,设置该页面的分享信息,从1.9.3开始支持。
- 用户点击"分享"按钮(button 组件 open-type="share")或者页面右上角菜单的"分享"按钮的时候会调用;
- 此事件需要 return 一个Object,用于自定义分享内容。
方法参数:Object object
object
参数说明:
参数名 | 类型 | 默认值 | 说明 |
---|---|---|---|
from | String | - | 分享事件来源。btn:页面内转发按钮;menu:右上角分享菜单 |
webViewUrl | String | - | 页面中包含webview时,返回当前webview的url |
return自定义转发内容:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
title | String | 否 | 当前小程序的名字 | 转发标题,不超过25字。 |
desc | String | 否 | 当前小程序的摘要 | 转发分享摘要,不超过25字。 |
imageUrl | String | 否 | 当前小程序的默认图标 | 转发显示图片的链接,目前仅支持url链接。 |
path | String | 否 | - | 转发页面 path,必须是以 / 开头的完整路径。 |
success | Function | 否 | - | 接口调用成功的回调函数 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
channel | String | 分享所选择的渠道,包括wechat、qq、qzone、ecommand |
result | Boolean | 分享是否成功 |
示例:
- 在 js 文件中
Page({
onShareAppMessage(params) {
return {
title: '分享标题',
desc: '分享摘要',
imageUrl: 'https://xxx.png',
path: '/index/index',
success(res) {
// 分享成功
console.log('分享渠道为' + res.channel);
console.log('分享结果为' + res.result);
},
fail(err) {
// 分享失败
}
};
}
});