0.0.2 • Published 8 years ago

star-m-share v0.0.2

Weekly downloads
6
License
-
Repository
-
Last release
8 years ago

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.OP4 = function(opts) { ... };
  • share.FLAG_XXX = 4;

API

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

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

回调说明

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