小程序的分享 onShareAppMessage(options)

 

在页面的js文件中定义了

onShareAppMessage 函数时，页面可以表示改页面可以转发。可以在函数中设置页面转发的信息。

1. 只有定义了该函数，小程序右上角的菜单中才会有转发按钮

2. 用户点击转发按钮的时候回调用该函数

3. 该函数内需要 return 一个 Object，Object中包含转发的信息（可自定义转发的内容）

 

页面中有可以触发转发事件的地方有两个：

　　一个是右上角菜单中的转发按钮

　　另一个是页面中具有属性open-type且其值为share的button。（注：必须是button组件，其他组件中设置 open-type="share" 无效）

　　即：<button data-name="shareBtn" open-type="share">转发</button>

　　注意：实际开发中会发现这个 button 自带有样式，当背景颜色设置为白色的时候还有一个黑色的边框，刚开始那个边框怎么都去不掉，后来给button加了一个样式属性 plain="true" 以后，再在样式文件中控制样式 button[plain]{ border:0 } ，就可以比较随便的自定义样式了，比如说将分享按钮做成一个图标等

 

触发分享事件后调用的函数：

onShareAppMessage: function( options ){　　var that = this;　　// 设置菜单中的转发按钮触发转发事件时的转发内容　　var shareObj = {　　　　title: "转发的标题",        // 默认是小程序的名称(可以写slogan等)　　　　path: '/pages/share/share',        // 默认是当前页面，必须是以‘/’开头的完整路径　　　　imgUrl: '',     //自定义图片路径，可以是本地文件路径、代码包文件路径或者网络图片路径，支持PNG及JPG，不传入 imageUrl 则使用默认截图。显示图片长宽比是 5:4　　　　success: function(res){　　　　　　// 转发成功之后的回调　　　　　　if(res.errMsg == 'shareAppMessage:ok'){　　　　　　}　　　　},　　　　fail: function(){　　　　　　// 转发失败之后的回调　　　　　　if(res.errMsg == 'shareAppMessage:fail cancel'){　　　　　　　　// 用户取消转发　　　　　　}else if(res.errMsg == 'shareAppMessage:fail'){　　　　　　　　// 转发失败，其中 detail message 为详细失败信息　　　　　　}　　　　},　　　　complete: function(){　　　　　　// 转发结束之后的回调（转发成不成功都会执行）　　　　}　　};　　// 来自页面内的按钮的转发　　if( options.from == 'button' ){　　　　var eData = options.target.dataset;　　　　console.log( eData.name );     // shareBtn　　　　// 此处可以修改 shareObj 中的内容　　　　shareObj.path = '/pages/btnname/btnname?btn_name='+eData.name;　　}　　// 返回shareObj　　return shareObj;}