在 Page 中定義 onShareAppMessage 事件處理函式，自定義該頁面的轉發內容。

onShareAppMessage(Object)

監聽使用者點選頁面內轉發按鈕（<button> 元件 open-type="share"）或右上角選單“轉發”按鈕的行為，並自定義轉發內容。

注意：只有定義了此事件處理函式，右上角選單才會顯示“轉發”按鈕

Object 引數說明：

此事件需要 return 一個 Object，用於自定義轉發內容，返回內容如下：

自定義轉發內容

示例程式碼

Page({
  onShareAppMessage: function (res) {
    if (res.from === 'button') {
      // 來自頁面內轉發按鈕
      console.log(res.target)
    }
    return {
      title: '自定義轉發標題',
      path: '/page/user?id=123'
    }
  }
})

wx.showShareMenu(OBJECT)

顯示當前頁面的轉發按鈕

OBJECT引數說明：

示例程式碼：

wx.showShareMenu({
  withShareTicket: true
})

wx.hideShareMenu(OBJECT)

隱藏轉發按鈕

OBJECT引數說明：

示例程式碼：

wx.hideShareMenu()

wx.updateShareMenu(OBJECT)

更新轉發屬性

OBJECT引數說明：

示例程式碼：

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

wx.getShareInfo(OBJECT)

獲取轉發詳細資訊

OBJECT引數說明：

CALLBACK 引數說明：

encryptedData 解密後為一個 JSON 結構，包含欄位如下：

獲取更多轉發資訊

通常開發者希望轉發出去的小程式被二次開啟的時候能夠獲取到一些資訊，例如群的標識。現在通過呼叫 wx.showShareMenu 並且設定 withShareTicket 為 true ，當用戶將小程式轉發到任一群聊之後，此轉發卡片在群聊中被其他使用者開啟時，可以在 App.onLaunch() 或 App.onShow 獲取到一個 shareTicket。通過呼叫 wx.getShareInfo() 介面傳入此 shareTicket 可以獲取到轉發資訊。

頁面內發起轉發

通過給 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進行功能開發。