targetkiller / h5share

各社交平台分享组件,集合了微信、空间、手Q、音乐、K歌等平台。

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

#H5SHARE

##介绍

不同社交平台的自定义分享接口不统一,且存在分享接口拉取失败的可能,会导致分享出去的内容(标题、描述、缩略图)不合理。该组件集合了微信、空间、手Q、音乐、K歌等社交平台自定义分享接口,并作了自定义失败默认拉取指定信息的处理,大大增强社交分享的成功率。

附一个分享网站:社交平台分享检测工具

##接口 目前有1个构造函数,3个方法。

构造函数 var hs = h5share(config); 更新分享信息 hs.update(); 弹出分享框 hs.showShareMenu(); 获取终端信息 hs.getTerm();

##用法 1.引用插件:

<script type='text/javascript' src='h5share.js'></script>

2.构造方法传参:

//返回hs对象,可用于链式调用其他方法。
var config = {
  //基础信息
  'title':title,//必填,用于分享的标题
  'desc':desc,//必填,用于分享的描述
  'url':url,//必填,用于分享的链接
  'img':img,//必填,用于分享的缩略图,建议250x250

  //微信信息,参考微信JSSDK配置
  'appId':appId,//必填,公众号的唯一标识
  'timestamp':timestamp,//必填,生成签名的时间戳
  'nonceStr':nonceStr,//必填,生成签名的随机串
  'signature':signature,//必填,签名

  //调试
  'debug':false//选填,若为true会弹出状态信息,默认false
}

//直接配置信息
h5share(config);

//或者拿到对象,支持链式调用其他方法
var hs = h5share(config);

3.其他方法

hs.update(config); //更新配置信息

hs.update({
  'title':title,//选填,修改后的分享的标题
  'desc':desc,//选填,修改后的分享的描述
  'url':url,//选填,修改后的分享的链接
  'img':img,//选填,修改后的分享的缩略图
});

hs.showShareMenu(callback); //弹出分享窗口(只有空间、手Q支持)

//回调函数,可选						
hs.showShareMenu(function(state){
  if(state==false){
    //弹出"点击右上角图标分享"提示
  }
});

hs.getTerm(); //获取当前平台终端

//获取匹配的终端类型
var result = hs.getTerm();

//结果返回
'wechat':微信
'qq':手机QQ
'qzone':QQ空间
'music':QQ音乐
'kge':全民K歌
'other':其他平台,若other表示不能自定义分享

4.CMD规范

引入了CMD规范支持,可直接用SeaJs或CommonJS等实现模块化。

var h5share = require('h5share');

##体验 demo地址 http://www.isux.us/h5/h5share/index.html

##License MIT

About

各社交平台分享组件,集合了微信、空间、手Q、音乐、K歌等平台。


Languages

Language:JavaScript 100.0%