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

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

Bug & Tip

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