star-m-share

移动端share分享组件，现继承手Q分享和微信内嵌页分享

MQQ JS API

微信WebView常用JS API介绍

依赖说明

• jquery
• qqapi

使用说明

初始化

share.init(opt);

MQQ分享消息

// opts: 同init参数
// type: 分享类型，0：QQ好友；1：QQ空间；2：微信好友；3：微信朋友圈
// cb: 4.7.2版本以下不支持此分享，这时会调用cb
share.MQQShareMessage(opts, type, cb);

展示MQQ分享面板

// opts: 同init参数
// onMQQShowShareMenu: function，面板展示之后回调
// cb: 5.2版本以下不支持此分享，这时会调用cb
share.MQQShowShareMenu(opts, cb);

微信分享好友

// opts: 同init参数
share.WeiXinShareToFriend(opts);

微信分享朋友圈

// opts: 同init参数
share.WeiXinShareToTimeline(opts);

静态扩展，永久可用：

• 在OP内添加分享组件的初始化代码，key为位数值，从低到高，如1，2，4，8，value为function(opts)
• 在share内添加flag常量供用户使用

动态扩展，页面内可用，同静态扩展，只是用程序来实现上面两个步骤

• share.OP[4] = function(opts) { ... };
• share.FLAG_XXX = 4;

API

属性、方法、事件、返回值等说明列表

| 属性 | 说明 | 类型 | 默认值 | | :--- | :--- | :--- | :--- | | flag | 初始化组件标识位，目前有share.FLAG_MQQ和share.FLAG_WEIXIN两个，可组合 | number | undefined | | title | 分享标题,会被<meta itemprop="name" content="..."/>覆盖 | string | '分享' | | desc | 分享描述,会被<meta itemprop="description" content="..."/>覆盖 | string | '点击查看详情' | | image | 分享图片链接,会被<meta itemprop="image" content="..."/>覆盖 | string | undefined | | url | 分享链接 | string | location.href | | beforeMQQShare | 在MQQ分享之前调用，可以修改分享内容 | function | undefined | | beforeMQQShareTimeline | 在MQQ分享微信朋友圈之前调用，可以修改分享内容，因为分享朋友圈默认会把desc隐藏 | function | undefined | | onMQQShareBtnClick | 在MQQ分享面板中点击了分享类型之后回调 | function | undefined | | onMQQShare | MQQ分享回调，注：IOS不支持回调，分享微信好友和朋友圈不支持回调 | function | undefined | | beforeWeiXinShareToFriend | 在微信分享好友之前调用，可以修改分享内容 | function | undefined | | beforeWeiXinShareTimeline | 在微信分享朋友圈之前调用，可以修改分享内容，因为分享朋友圈默认会把desc隐藏 | function | undefined | | onShareWeiXinFriend | 微信分享好友回调 | function | undefined | | onShareWeiXinTimeline | 微信分享朋友圈回调 | function | undefined |

回调说明

beforeMQQShare: function，在MQQ分享之前调用，可以修改分享内容
- args:
  - shareParams: 分享内容对象
- return:
  - shareParams: 修改之后的分享内容对象

beforeMQQShareTimeline: function，在MQQ分享微信朋友圈之前调用，可以修改分享内容，因为分享朋友圈默认会把desc隐藏，因此与分享好友分开
  - args:
    - shareParams: 分享内容对象，title已经替换为desc，原来的title在otitle字段
  - return:
    - shareParams: 修改之后的分享内容对象

onMQQShareBtnClick: function，在MQQ分享面板中点击了分享类型之后回调
  - args:
    - type: 用户点击的分享类型，0：QQ好友；1：QQ空间；2：微信好友；3：微信朋友圈
  - return: none

onMQQShare: function，MQQ分享回调，注：IOS不支持回调，分享微信好友和朋友圈不支持回调
  - args: （注：4.6版本以下无参数）
    - result: MQQ分享结果
      - retCode: 0：用户点击发送，完成整个分享流程；1：用户点击取消，中断分享流程
    - type: 用户点击的分享类型，0：QQ好友；1：QQ空间；2：微信好友；3：微信朋友圈
  - return: none

beforeWeiXinShareToFriend: function，在微信分享好友之前调用，可以修改分享内容
  - args:
    - shareParams: 分享内容对象
  - return:
    - shareParams: 修改之后的分享内容对象

beforeWeiXinShareTimeline: function，在微信分享朋友圈之前调用，可以修改分享内容，因为分享朋友圈默认会把desc隐藏，因此与分享好友分开
  - args:
    - shareParams: 分享内容对象，title已经替换为desc，原来的title在otitle字段
  - return:
    - shareParams: 修改之后的分享内容对象

onShareWeiXinFriend: function，微信分享好友回调
  - args:
    - res: 分享结果
      - err_msg: send_app_msg:cancel 用户取消
                 send_app_msg:ok 分享成功
                 fail: 分享失败
  - return: none

onShareWeiXinTimeline: function，微信分享朋友圈回调
  - args:
    - res: 分享结果
      - err_msg: share_timeline:cancel 用户取消，注：检测用户取消动作只有IOS支持
                 share_timeline:ok 分享成功
                 fail: 分享失败
  - return: none