onShareAppMessage(options)

在 Page 中界说 onShareAppMessage 函数，，设置该页面的转发信息。。。

• 只有界说了此事务处理函数，，右上角菜单才会显示“转发”按钮
• 用户点击转发按钮的时间会挪用
• 此事务需要 return 一个 Object，，用于自界说转发内容

回调效果：

success回调参数说明：

示例代码：

Page({
  onShareAppMessage: function (res) {
    if (res.from === 'button') {
      // 来自页面内转发按钮
      console.log(res.target)
    }
    return {
      title: '自界说转发问题',
      path: '/page/user?id=123',
      success: function(res) {
        // 转发乐成
      },
      fail: function(res) {
        // 转发失败
      }
    }
  }
})

wx.showShareMenu(OBJECT)

基础库版本 1.1.0 最先支持，，低版本需做兼容处理

显示目今页面的转发按钮

OBJECT参数说明：

示例代码：

wx.showShareMenu({
  withShareTicket: true
})

wx.hideShareMenu(OBJECT)

基础库版本 1.1.0 最先支持，，低版本需做兼容处理

隐藏转发按钮

OBJECT参数说明：

示例代码：

wx.hideShareMenu()

wx.updateShareMenu(OBJECT)

基础库 1.2.0 最先支持，，低版本需做兼容处理

更新转发属性

OBJECT参数说明：

示例代码：

wx.updateShareMenu({
  withShareTicket: true,
  success() {
  }
})

wx.getShareInfo(OBJECT)

基础库 1.1.0 最先支持，，低版本需做兼容处理

获取转发详细信息

OBJECT参数说明：

CALLBACK 参数说明：

encryptedData 解密后为一个 JSON 结构，，包括字段如下：

Tip: 如需要展示群名称，，可以使用开放数据组件

获取更多转发信息

通？？⒄呦Ｍ⒊鋈サ男〕绦虮欢次翻开的时间能够获取到一些信息，，例如群的标识。。。现在通过挪用 wx.showShareMenu 并且设置 withShareTicket 为 true ，，当用户将小程序转发到任一群聊之后，，可以获取到此次转发的 shareTicket，，此转发卡片在群聊中被其他用户翻开时，，可以在 App.onLaunch() 或 App.onShow 获取到另一个 shareTicket。。。这两步获取到的 shareTicket 均可通过 wx.getShareInfo() 接口可以获取到相同的转发信息。。。

页面内提倡转发

基础库 1.2.0 最先支持，，低版本需做兼容处理

通过给 button 组件设置属性 open-type="share"，，可以在用户点击按钮后触发 Page.onShareAppMessage() 事务，，若是目今页面没有界说此事务，，则点击后无效果。。。相关组件：button

使用指引

转发按钮，，旨在资助用户更流通地与挚友分享内容和服务。。。转发，，应是用户自觉的行为，，且在需要时触手可及。。？？⒄咴谑褂檬比糇翊右韵轮敢，，会获得更佳的用户体验。。。

1. 寄义清晰：明确、一目了然的图形按钮，，将为用户镌汰明确的时间。。。在pp电子资源下载中心，，你可以找到这样的按钮素材并直接使用。。。；；蛘吣憧梢云局ぷ约河档纳杓破，，无邪设计寄义清晰的按钮的样式。。。虽然，，你也可以直接使用带文案的按钮，，“转发给挚友”，，它也足够明确。。。
2. 利便点击：按钮点击热区不宜过小，，亦不宜过大。。。同时，，转发按钮与其他按钮一样，，热区也不宜过密，，以免用户误操作。。。
3. 按需泛起：并非所有页面都适合放置转发按钮，，涉及用户隐私的非果真内容，，或可能打断用户完成目今操作体验的场景，，该功效并不推荐使用。。。同时，，由于转发历程中，，我们将截取用户屏幕图像作为配图，，因此，，需要注重资助用户屏障个人信息。。。
4. 尊重意愿：理所虽然，，并非所有的用户，，都喜欢与朋侪分享你的小程序。。。因此，，它不应该成为一个诱导或强制行为，，如转发后才华解锁某项功效等。。。请注重，，这类做法不但不被推荐，，还可能违反pp电子《运营规范》，，我们强烈建议你在使用前阅读这部分内容。。。

以上，，我们摆设了最主要的几点，，若是你有时间，，可以完整浏览《设计指南》，，相信会有更多的收获。。。

Bug & Tip

1. tip: 转发图片不可自界说；；；会取目今页面，，从顶部最先，，高度为 80% 屏幕宽度的图像作为转发图片。。。
2. tip: 转发的调试支持请审查 通俗转发的调试支持 和 带 shareTicket 的转发
3. tip: 只有转发到群聊中翻开才可以获取到 shareTickets 返回值，，单聊没有 shareTickets
4. tip: shareTicket 仅在目今小程序生命周期内有用
5. tip: 由于战略变换，，小程序群相关能力举行调解，，开发者可先使用wx.getShareInfo接口中的群ID举行功效开发。。。