赞
踩
监听用户点击页面内转发按钮(button 组件 open-type="share"
)或右上角菜单“转发”按钮的行为,并自定义转发内容。
注意:只有定义了此事件处理函数,右上角菜单才会显示“转发”按钮
参数 Object object:
参数 | 类型 | 说明 | 最低版本 |
---|---|---|---|
from | String | 转发事件来源。button :页面内转发按钮;menu :右上角转发菜单 | 1.2.4 |
target | Object | 如果 from 值是 button ,则 target 是触发这次转发事件的 button ,否则为 undefined | 1.2.4 |
webViewUrl | String | 页面中包含web-view组件时,返回当前web-view的url | 1.6.4 |
此事件处理函数需要 return 一个 Object,用于自定义转发内容,返回内容如下:
自定义转发内容 基础库 2.8.1 起,分享图支持云图片。
字段 | 说明 | 默认值 | 最低版本 |
---|---|---|---|
title | 转发标题 | 当前小程序名称 | |
path | 转发路径 | 当前页面 path ,必须是以 / 开头的完整路径 | |
imageUrl | 自定义图片路径,可以是本地文件路径、代码包文件路径或者网络图片路径。支持PNG及JPG。显示图片长宽比是 5:4。 | 使用默认截图 | 1.5.0 |
promise | 如果该参数存在,则以 resolve 结果为准,如果三秒内不 resolve,分享会使用上面传入的默认参数 |
使用案例1:
- /**
- * 用户点击右上角分享
- */
- onShareAppMessage: function () {
- var config = this.data.config;
- var url = ''
- if (account.isLogin()) {
- var user = account.getUserInfo()
- url = 'pages/index/index?userid=' + user.id
- } else {
- url = 'pages/index/index'
- }
- return {
- title: config.shareTitle,
- imageUrl: (config.shareImg ? this.data.domain + config.shareImg : ''),
- path: url
- };
- },
使用案例2:
- Page({
- onShareAppMessage() {
- const promise = new Promise(resolve => {
- setTimeout(() => {
- resolve({
- title: '自定义转发标题'
- })
- }, 2000)
- })
- return {
- title: '自定义转发标题',
- path: '/page/user?id=123',
- promise
- }
- }
- })
监听右上角菜单“分享到朋友圈”按钮的行为,并自定义分享内容。
注意:只有定义了此事件处理函数,右上角菜单才会显示“分享到朋友圈”按钮
自定义转发内容
事件处理函数返回一个 Object,用于自定义分享内容,不支持自定义页面路径,返回内容如下:
字段 | 说明 | 默认值 | 最低版本 |
---|---|---|---|
title | 自定义标题,即朋友圈列表页上显示的标题 | 当前小程序名称 | |
query | 自定义页面路径中携带的参数,如 path?a=1&b=2 的 “?” 后面部分 | 当前页面路径携带的参数 | |
imageUrl | 自定义图片路径,可以是本地文件或者网络图片。支持 PNG 及 JPG,显示图片长宽比是 1:1。 |
完整使用案例:
- /**
- * 用户点击右上角分享
- */
- onShareAppMessage: function () {
- var config = this.data.config;
- var url = ''
- if (account.isLogin()) {
- var user = account.getUserInfo()
- url = 'pages/index/index?userid=' + user.id
- } else {
- url = 'pages/index/index'
- }
- return {
- title: config.shareTitle,
- imageUrl: (config.shareImg ? this.data.domain + config.shareImg : ''),
- path: url
- };
- },
- onShareTimeline: function () {
- //处理分享朋友圈
- var data = this.onShareAppMessage();
- if (data.path) {
- data.query = data.path.substring(data.path.lastIndexOf('?') + 1);
- }
- return data;
- }
更多:
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。