| 分类 mini  | 标签 小程序  分享 

title

引言

小程序支持分享给好友(会话)或分享到朋友圈。分享给好友通过页面中定义 onShareAppMessage 配置,用户点击右上角「…」或按钮 open-type="share" 时触发;分享到朋友圈通过 onShareTimeline 配置,用户点击「分享到朋友圈」时触发。可自定义标题、路径、图片等,实现带参数的分享链接,便于统计来源和个性化展示。

本文介绍两种分享方式的配置与使用。注意:分享到朋友圈需在 app.json 的 window 中开启 enableShareTimeline,且从朋友圈打开的小程序为「单页模式」,需适配无 tabBar、无返回键等差异。

分享给好友

在页面中定义 onShareAppMessage,返回配置对象。若不定义,则使用小程序默认分享(首页、默认标题)。通过 button open-type="share" 可指定在点击某按钮时触发分享,此时会执行页面的 onShareAppMessage。

Page({
  onShareAppMessage() {
    return {
      title: '推荐给你一个好物',
      path: '/pages/detail/detail?id=' + this.data.id,
      imageUrl: this.data.shareImage
    };
  }
});

path 可带查询参数,好友打开时在 onLoad(options) 中获取。imageUrl 为自定义图片路径,建议比例 5:4,不设置则使用小程序截图。

分享到朋友圈

onShareTimeline 返回的对象中,query 为页面参数(格式同 URL query),title 为分享标题,imageUrl 为自定义图片。朋友圈打开时,小程序以单页模式运行,仅展示当前页,无 tabBar,需在页面内提供返回或跳转入口。

Page({
  onShareTimeline() {
    return {
      title: '分享标题',
      query: 'id=' + this.data.id,
      imageUrl: this.data.shareImage
    };
  }
});

需在 app.json 的 window 中配置 "enableShareTimeline": true。朋友圈打开为单页模式,需适配。

总结

合理配置分享标题、路径和图片,可提升传播效果。注意 path/query 参数长度限制(总长度有限),避免过长导致异常。建议根据分享内容动态生成 title 和 path,便于追踪和个性化。


上一篇     下一篇