轉發
hideShareMenu
TIP
該API使用方法為: wx.hideShareMenu(Object object)
- 功能說明: 按一下右上角選單時隱藏'分享給好友'按鈕。
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| hideShareItems | Array.<string> | 'luffaChatFriends' | 否 | luffaChatFriends:控制是否隱藏'分享到宿主用戶端Luffa朋友圈',不帶hideShareItems參數默認'轉發'、'分享到宿主用戶端Luffa朋友'、'控制是否控制隱藏'全隱藏 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
- 示例代碼:
js
wx.hideShareMenu({
hideShareItems: ['LuffachatFriends']
})showShareMenu
TIP
該API使用方法為: wx.showShareMenu(Object object)
- 功能說明: 按一下右上角選單時顯示、'分享到宿主用戶端Luffa好友'、'分享到宿主用戶端Luffa朋友圈'按鈕。
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| showShareItems | Array.<string> | 'LuffachatFriends' | 否 | 請查看下麵 object.showShareItems參數說明 |
| withShareTicket | boolean | false | 否 | 是否使用帶shareTicket的轉發,Android從基礎庫1.4.0版本、iOS從基礎庫1.4.0版本開始支持 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
object.showShareItems參數
值 說明 'wechatFriends' 控制是否展示'宿主用戶端Luffa好友' 示例代碼:
js
wx.showShareMenu({
showShareItems: ['qq', 'qzone', 'wechatFriends', 'wechatMoment']
})updateShareMenu
TIP
該API使用方法為: wx.updateShareMenu(Object object)
- 功能說明: 更新轉發内容。
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| withShareTicket | boolean | false | 否 | 是否使用帶shareTicket的轉發 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
- 示例代碼:
js
wx.updateShareMenu({
withShareTicket: true
})showShareImageMenu
TIP
該API使用方法為: wx.showShareImageMenu(Object object)
- 功能說明: 打開分享圖片彈窗,可以將圖片發送給朋友、收藏或下載。
- 參數及說明: Object object。
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| path | string | - | 是 | 要分享的圖片地址,必須為本地路徑或臨時路徑 |
| style | string | default | 否 | 分享樣式 |
| needShowEntrance | string | false | 否 | 分享的圖片消息是否要帶小程序入口(僅部分小程序類目可用) |
| entrance | string | false | 否 | 從消息小程序入口打開小程序的路徑,如果當前頁面允許分享給朋友,則默認為當前頁面路徑,否則默認為小程序首頁 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數(無論成功與否都執行) |
- 示例代碼:
js
wx.downloadFile({
url: 'https://res.wx.qq.com/wxdoc/dist/assets/img/demo.ef5c5bef.jpg',
success: (res) => {
wx.showShareImageMenu({
path: res.tempFilePath
})
}
})onCopyUrl
TIP
該API使用方法為: wx.onCopyUrl(function listener)
- 功能說明: 監聽用戶點擊右上角選單的「複製連結」按鈕時觸發的事件。 本接口為Beta版本,暫只在Android平臺支持
- 參數及說明:
- function listener, 用戶點擊右上角選單的「複製連結」按鈕時觸發的事件的監聽函數。
- Object res,
| 内容 | 類型 | 說明 |
|---|---|---|
| query | string | 用短鏈打開小程序時當前頁面攜帶的査詢字串。 小程序中使用時,應在進入頁面時調用wx.onCopyUrl自定義query,退出頁面時調用wx.offCopyUrl,防止影響其它頁面 |
- 示例代碼:
js
// on
wx.onCopyUrl(() => {
return { query: 'a=1&b=2' }
})
// off
wx.offCopyUrl()offCopyUrl
TIP
該API使用方法為: wx.offCopyUrl()
功能說明: 移除用戶點擊右上角選單的「複製連結」按鈕時觸發的事件的全部監聽函數。
示例代碼:
js
// on
wx.onCopyUrl(() => {
return { query: 'a=1&b=2' }
})
// off
wx.offCopyUrl()