微信小程序提供了onShareAppMessage方法降宅,專門用來監(jiān)聽用戶點擊頁面內(nèi)轉(zhuǎn)發(fā)按鈕(button 組件 open-type="share")或右上角菜單“轉(zhuǎn)發(fā)”按鈕的行為寥茫,并自定義轉(zhuǎn)發(fā)內(nèi)容。
> 注意:只有定義了此事件處理函數(shù)甲锡,右上角菜單才會顯示“轉(zhuǎn)發(fā)”按鈕
參數(shù) | 類型 | 說明 | 最低版本 |
---|---|---|---|
from | String | 轉(zhuǎn)發(fā)事件來源后专。 button :頁面內(nèi)轉(zhuǎn)發(fā)按鈕溯壶; menu :右上角轉(zhuǎn)發(fā)菜單 |
1.2.4 |
target | Object | 如果 from 值是 button 哈蝇,則 target 是觸發(fā)這次轉(zhuǎn)發(fā)事件的 button ,否則為 undefined
|
1.2.4 |
webViewUrl | String | 頁面中包含web-view組件時薪寓,返回當前web-view的url | 1.6.4 |
此事件處理函數(shù)需要 return 一個 Object亡资,用于自定義轉(zhuǎn)發(fā)內(nèi)容,返回內(nèi)容如下:
自定義轉(zhuǎn)發(fā)內(nèi)容 基礎(chǔ)庫 2.8.1 起向叉,分享圖支持云圖片锥腻。
字段 | 說明 | 默認值 | 最低版本 |
---|---|---|---|
title | 轉(zhuǎn)發(fā)標題 | 當前小程序名稱 | |
path | 轉(zhuǎn)發(fā)路徑 | 當前頁面 path ,必須是以 / 開頭的完整路徑 | |
imageUrl | 自定義圖片路徑母谎,可以是本地文件路徑瘦黑、代碼包文件路徑或者網(wǎng)絡(luò)圖片路徑。支持PNG及JPG奇唤。顯示圖片長寬比是 5:4幸斥。 | 使用默認截圖 | 1.5.0 |
promise | 如果該參數(shù)存在,則以 resolve 結(jié)果為準咬扇,如果三秒內(nèi)不 resolve甲葬,分享會使用上面?zhèn)魅氲哪J參數(shù) | 2.12.0 |
示例代碼
PS:卡片圖片imageUrl可以是本地的,也可以服務(wù)器上傳的url
onShareAppMessage() {
return {
title: '分享出去的卡片標題',
path: '/index/index?id=123',
imageUrl: '/img/bg.jpg'
}
}
如果要禁止當前頁面的小程序卡片分享懈贺,則可以在onLoad中通過以下方式:
wx.hideShareMenu()