swan.openShare

解释：调起分享面板。
Web 态说明：Web 态小程序运行在微信、QQ、QQ 空间、微博、百度 Hi 内时，调用 openShare 会弹出引导浮层引导用户通过平台的分享能力进行分享；在非上述环境时会弹出分享面板提示用户复制链接并分享。

方法参数

Object object

object 参数说明

属性名类型必填默认值说明Web 态说明
titleString否分享标题暂不支持
contentString否分享内容暂不支持
imageUrlString否分享图标暂不支持
pathString否页面 path ，必须是以 / 开头的完整路径。如果 path 中的参数包含中文字符，需通过 encodeURIComponent 对中文字符进行编码Web 态小程序运行在微信、QQ、QQ 空间、微博、百度 Hi 内时配置的分享 path 不生效，此时分享 path 为当前页面的路径
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

函数返回值

Boolean result

返回值说明

反馈分享结果，成功或失败。

fail 返回值参数说明

Web 态

错误信息（errMsg）类型说明
url copy failString分享链接复制到剪切板失败
share canceledString取消分享面板
sharing guide canceledString取消分享引导弹层

示例

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

扫码体验

代码示例

百度智能小程序

请使用百度APP扫码

图片示例

swan.openShare - 图2

代码示例

  • SWAN
  • JS
  1. <view class="wrap">
  2.     <view class="card-area">
  3.         <button type="primary" open-type="share">组件方式打开分享</button>
  4.         <button type="primary" bindtap="openShare">API调用打开分享</button>
  5.         <view class="tip-week">不同方式调起分享面板</view>
  6.     </view>
  7. </view>
  1. Page({
  2.     onShareAppMessage() {
  3.         return {
  4.             title: '小程序标题',
  5.             content: '世界很复杂，百度更懂你',
  6.             imageUrl: 'https://b.bdstatic.com/miniapp/images/baidulogo1.jpg',
  7.             path: 'swan-api/open-share/open-share'
  8.         };
  9.     },
  10.     openShare() {
  11.         swan.openShare({
  12.             title: '智能小程序示例',
  13.             content: '世界很复杂，百度更懂你',
  14.             path: 'swan-api/open-share/open-share?key=value',
  15.             imageUrl: 'https://b.bdstatic.com/miniapp/images/baidulogo1.jpg',
  16.             success: res => {
  17.                 swan.showToast({
  18.                     title: '分享成功',
  19.                     icon: 'none'
  20.                 });
  21.                 console.log('openShare success', res);
  22.             },
  23.             fail: err => {
  24.                 console.log('openShare fail', err);
  25.             }
  26.         });
  27.     }
  28. });

截屏分享二维码说明

自百度 App 11.23 以来，小程序截屏分享增加了二维码图片标识。

注意：该二维码图片标识 60 天 内失效，请勿在其他场景中使用，如需要长期有效的二维码，请到开发者后台，或使用二维码开放接口生成。

截屏分享图片示例

swan.openShare - 图3

Bug & Tip

  • Tip：如果入参 path 中的参数包含中文字符，需要通过 encodeURIComponent 对中文字符进行编码，举例：
  1. let path = '/a/b?key=' + encodeURIComponent('中文');
  • Bug：基础库 1.13.43 版本 Android 手机中，点击分享面板的取消时，不会执行 fail 回调。