官方提供的自定义分享
使用隐式页面配置函数实现的全局分享——推荐
使用隐式路由实现的全局分享——不推荐,仅供了解隐式路由
结合隐式页面函数、隐式路由实现所有页面分享配置及控制(页面无需再开启或自定义配置)——强烈推荐
前言:
目前微信小程序只开放了页面自定义分享的API,为了能够更灵活的进行分享配置、满足运营的需求,本文总结了微信小程序分享转发的多种用法,其中包括官方提供的页面自定义分享,使用隐式路由和页面配置实现的全局分享和全局+自定义的分享组合方式,希望能对需要实现分享多样化的同学有所帮助。
官方提供的自定义分享:
先看下官网介绍:
如上,只有定义了转发函数,才能分享页面,如此如果只需分享页面,只需要定义分享函数即可:
onShareAppMessage(res) { }
如果需要自定义分享内容,则需要对函数进行配置,如下:
onShareAppMessage: function (res) {
return {
title: '自定义转发标题',
path: '/page/user?id=123'
}
}
})
如上,如果需要自定定义全局分享,则可以将全局分享的内容对象配置在app.js中的全局变量中,然后所有需要分享的页面中配置到分享函数中去就好了,如下:
//App.js 全局数据
globalData: {
//分享内容
globalShareInfo: {
title: '全局分享标题',
path: '/pages/login/index',
imageUrl: 'https://shopv3.oss-cn-hangzhou.aliyuncs.com/gift/ep/other/share.jpg'
}
}
总体来说,微信小程序要设置全局分享还是比较麻烦的,你需要每个页面都要去开启,相对来说支付宝小程序提供有全局分享就要好多了。
那么微信小程序能不能实现支付宝小程序一样的全局分享呢?经过一番探索研究,从微信小程序底层的一些隐式函数实现了全局分享的功能,如支付宝小程序一样,一处配置,全局有效。
全局自定义分享——使用微信小程序隐式页面配置函数实现:
demo代码片段点击下载
本例使用了隐式函数 Page 以及返回对象 pageConfig 来对当前访问页面进行自定义分享配置,具体代码如下:
1 // app.js
2 /**
3 * 全局分享配置,页面无需开启分享
4 * 如页面开启分享开关,则走页面分享配置(即使未配置内容)
5 */
6 ! function() {
7 //获取页面配置并进行页面分享配置
8 var PageTmp = Page
9 Page = function(pageConfig) {
10 let view = Page
11 //全局开启分享
12 pageConfig = Object.assign({
13 onShareAppMessage: function() {
14
15 }
16 }, pageConfig);
17 //3. 配置页面模板
18 PageTmp(pageConfig);
19 }
20 }();
如上,只需要在小程序主入口app.js中写入以上代码对页面分享进行直接配置就好了(App()外边)。
功能表现:
只需要入口js中配置如上代码,即可实现全局自定义分享;
如果页面配置有分享事件的函数,那么全局分享将失效,直接走页面的分享(即使页面分享未配置内容,只要打开就会走页面分享);
经多次验证,上述方法实现的全局分享自动携带当前页面的完整参数,无需另外获取。
如果需要配置全局分享图片或者标题,直接在 onShareAppMessage 函数中配置就好了,如下:
1 pageConfig = Object.assign({
2 onShareAppMessage: function () {
3 return {
4 title:"自定义全局分享",
5 imageUrl: wx.getStorageSync("shareUrl")
6 }
7 }
8 }, pageConfig);
使用隐式路由间接实现全局分享配置:
这种方法就没上边的好用了,但是涉及到隐式路由的使用,有兴趣的可以了解下,需要注意的是这种方法间接实现全局分享只是修改分享配置,前提是页面必须配置分享事件函数,否则无效。
这种全局分享的实现方法不建议用,就当了解下微信小程序的隐式路由的使用就好了。具体代码如下:
1 App({
2 onLaunch: function() {
3 this.overShare()
4 },
5 /**
6 * 间接实现全局设置分享内容(需要页面配置分享事件函数)
7 */
8 overShare: function() {
9 let self = this
10 // 调用隐藏路由回调
11 wx.onAppRoute(function(res) {
12 //获取加载的页面
13 let pages = getCurrentPages(),
14 //获取当前页面的对象
15 view = pages[pages.length - 1],
16 data;
17 if (view) {
18 data = view.data;
19 if (true || !data.isOverShare) {
20 data.isOverShare = true;
21 view.onShareAppMessage = function() {
22 //重写分享配置
23 return {
24 title: '分享标题',
25 imageUrl: wx.getStorageSync("shareUrl")
26 };
27 }
28 }
29 }
30 })
31 },
32 })
总结:
通过上边的方式,我们已经实现了全局自定义分享。如果需要对大部分页面进行全局分享配置(指定标题、图片、页面路径),那么在app.js中的全局分享代码中进行配置就好了。对于部分需要单独配置的,可以直接在页面进行特定配置就好了。
如此,单个页面分享、全局分享、组合分享也就都可以实现了。
应用扩展——结合隐式页面函数、隐式路由实现所有页面分享配置及控制(页面无需再开启或自定义配置):
结合隐式路由,可实现全局控制所有页面的分享配置,包括全局分享、页面默认分享、页面自定义分享,如下图所示:
示例代码:
1 // app.js
2 /**
3 * 全局分享配置,页面无需开启分享
4 * 使用隐式页面函数进行页面分享配置
5 * 使用隐式路由获取当前页面路由,并根据路由来进行全局分享、自定义分享
6 */
7 ! function () {
8 //获取页面配置并进行页面分享配置
9 var PageTmp = Page
10 Page = function (pageConfig) {
11 //1. 获取当前页面路由
12 let routerUrl = ""
13 wx.onAppRoute(function (res) {
14 let pages = getCurrentPages(),
15 view = pages[pages.length - 1];
16 routerUrl = view.route
17 })
18
19 //2. 全局开启分享配置
20 pageConfig = Object.assign({
21 onShareAppMessage: function () {
22 //根据不同路由设置不同分享内容(微信小程序分享自带参数,如非特例,不需配置分享路径)
23 let shareInfo={}
24 let noGlobalSharePages=["index/index"]
25 //全局分享配置,如部分页面需要页面默认分享或自定义分享可以单独判断处理
26 if (!routerUrl.includes(noGlobalSharePages)){
27 shareInfo = {
28 title: "自定义全局分享",
29 imageUrl: wx.getStorageSync("shareUrl")
30 }
31 }
32 return shareInfo
33 }
34 }, pageConfig);
35 // 配置页面模板
36 PageTmp(pageConfig);
37 }
38 }();
如上,无需页面开启和配置,只需要在app.js中编写以上代码,即可对所有页面进行自定义分享配置。