• swan.openShare
  • 方法參數(shù)
    • object 參數(shù)說(shuō)明
    • 函數(shù)返回值
    • 返回值說(shuō)明
  • fail 返回值參數(shù)說(shuō)明
    • Web 態(tài)
  • 示例
    • 圖片示例
    • 代碼示例
  • 截屏分享二維碼說(shuō)明
    • 截屏分享圖片示例
  • Bug & Tip

swan.openShare

解釋：調(diào)起分享面板。
Web 態(tài)說(shuō)明：Web 態(tài)小程序運(yùn)行在微信、QQ、QQ 空間、微博、百度 Hi 內(nèi)時(shí)，調(diào)用 openShare 會(huì)彈出引導(dǎo)浮層引導(dǎo)用戶通過(guò)平臺(tái)的分享能力進(jìn)行分享；在非上述環(huán)境時(shí)會(huì)彈出分享面板提示用戶復(fù)制鏈接并分享。

方法參數(shù)

Object object

object 參數(shù)說(shuō)明

屬性名	類型	必填	默認(rèn)值	說(shuō)明	Web 態(tài)說(shuō)明
title	String	否		分享標(biāo)題	暫不支持
content	String	否		分享內(nèi)容	暫不支持
imageUrl	String	否		分享圖標(biāo)	暫不支持
path	String	否		頁(yè)面 path ，必須是以 / 開(kāi)頭的完整路徑。如果 path 中的參數(shù)包含中文字符，需通過(guò) encodeURIComponent 對(duì)中文字符進(jìn)行編碼	Web 態(tài)小程序運(yùn)行在微信、QQ、QQ 空間、微博、百度 Hi 內(nèi)時(shí)配置的分享 path 不生效，此時(shí)分享 path 為當(dāng)前頁(yè)面的路徑
success	Function	否		接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否		接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否		接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）

函數(shù)返回值

Boolean result

返回值說(shuō)明

反饋分享結(jié)果，成功或失敗。

fail 返回值參數(shù)說(shuō)明

Web 態(tài)

錯(cuò)誤信息（errMsg）	類型	說(shuō)明
url copy fail	String	分享鏈接復(fù)制到剪切板失敗
share canceled	String	取消分享面板
sharing guide canceled	String	取消分享引導(dǎo)彈層

示例

在開(kāi)發(fā)者工具中打開(kāi)

在開(kāi)發(fā)者工具中打開(kāi)

在 WEB IDE 中打開(kāi)

掃碼體驗(yàn)

代碼示例

請(qǐng)使用百度APP掃碼

圖片示例

代碼示例

• SWAN
• JS

 
 
 

  
  
  
  
  
  
 
  
  
  
 組件方式打開(kāi)分享
  
  
  
 API調(diào)用打開(kāi)分享
  
  
  
 不同方式調(diào)起分享面板
  
  
  
 
  
  
  
 
 
 

 
 
 

  
  
  
Page({
  
  
  
 onShareAppMessage() {
  
  
  
 return {
  
  
  
 title: '小程序標(biāo)題',
  
  
  
 content: '世界很復(fù)雜，百度更懂你',
  
  
  
 imageUrl: 'https://b.bdstatic.com/miniapp/images/baidulogo1.jpg',
  
  
  
 path: 'swan-api/open-share/open-share'
  
  
  
 };
  
  
  
 },
  
  
  
 openShare() {
  
  
  
 swan.openShare({
  
  
  
 title: '智能小程序示例',
  
  
  
 content: '世界很復(fù)雜，百度更懂你',
  
  
  
 path: 'swan-api/open-share/open-share?key=value',
  
  
  
 imageUrl: 'https://b.bdstatic.com/miniapp/images/baidulogo1.jpg',
  
  
  
 success: res => {
  
  
  
 swan.showToast({
  
  
  
 title: '分享成功',
  
  
  
 icon: 'none'
  
  
  
 });
  
  
  
 console.log('openShare success', res);
  
  
  
 },
  
  
  
 fail: err => {
  
  
  
 console.log('openShare fail', err);
  
  
  
 }
  
  
  
 });
  
  
  
 }
  
  
  
});
 
 
 

截屏分享二維碼說(shuō)明

自百度 App 11.23 以來(lái)，小程序截屏分享增加了二維碼圖片標(biāo)識(shí)。

注意：該二維碼圖片標(biāo)識(shí) 60 天 內(nèi)失效，請(qǐng)勿在其他場(chǎng)景中使用，如需要長(zhǎng)期有效的二維碼，請(qǐng)到開(kāi)發(fā)者后臺(tái)，或使用二維碼開(kāi)放接口生成。

截屏分享圖片示例

Bug & Tip

• Tip：如果入?yún)?path 中的參數(shù)包含中文字符，需要通過(guò) encodeURIComponent 對(duì)中文字符進(jìn)行編碼，舉例：

 
 
 

  
  
  
let path = '/a/b?key=' + encodeURIComponent('中文');
 
 
 

• Bug：基礎(chǔ)庫(kù) 1.13.43 版本 Android 手機(jī)中，點(diǎn)擊分享面板的取消時(shí)，不會(huì)執(zhí)行 fail 回調(diào)。

網(wǎng)站題目：創(chuàng)新互聯(lián)百度小程序教程：swan.openShare
文章URL：http://m.5511xx.com/article/cdpsigp.html