定义函数
在页面的js文件中定义 onShareAppMessage
函数时,表示该页面可以进行转发。可以在函数中设置页面转发的信息。
- 只有定义了该函数,小程序右上角的菜单中才会有转发按钮
- 用户点击转发按钮的时候回调用该函数
- 该函数内需要 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 shareObj = {
title: "转发的标题", // 小程序的名称
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: fucntion(){
// 转发结束之后的回调(转发成不成功都会执行)
}
};
// 来自页面内的按钮的转发
if( options.from == 'button' ){
console.log("来源于button");
// 此处可以修改 shareObj 中的内容
shareObj.path = '/pages/btnname/btnname?btn_name='+eData.name;
}
// 返回shareObj
return shareObj;
}
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。