页面事件处理函数

onShareAppMessage

解释:在 Page 中定义 onShareAppMessage 函数,设置该页面的分享信息,从1.9.3开始支持。

  • 用户点击"分享"按钮(button 组件 open-type="share")或者页面右上角菜单的"分享"按钮的时候会调用;
  • 此事件需要 return 一个Object,用于自定义分享内容。

方法参数:Object object

object参数说明

参数名类型默认值说明
fromString-分享事件来源。btn:页面内转发按钮;menu:右上角分享菜单
webViewUrlString-页面中包含webview时,返回当前webview的url

return自定义转发内容

参数名类型必填默认值说明
titleString当前小程序的名字转发标题,不超过25字。
descString当前小程序的摘要转发分享摘要,不超过25字。
imageUrlString当前小程序的默认图标转发显示图片的链接,目前仅支持url链接。
pathString-转发页面 path,必须是以 / 开头的完整路径。
successFunction-接口调用成功的回调函数
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明

参数类型说明
channelString分享所选择的渠道,包括wechat、qq、qzone、ecommand
resultBoolean分享是否成功

示例

  • 在 js 文件中
  1. Page({
  2. onShareAppMessage(params) {
  3. return {
  4. title: '分享标题',
  5. desc: '分享摘要',
  6. imageUrl: 'https://xxx.png',
  7. path: '/index/index',
  8. success(res) {
  9. // 分享成功
  10. console.log('分享渠道为' + res.channel);
  11. console.log('分享结果为' + res.result);
  12. },
  13. fail(err) {
  14. // 分享失败
  15. }
  16. };
  17. }
  18. });