声明:由于时间有限,目前仅对微信一部分接口进行了封装,陆续会持续增加封装,敬请关注!
微信公众平台 WeixinApi 感谢WeixinApi 因为使用习惯,同时也欢迎大家共同来维护
WeixinApi 的诞生
腾讯官方于2015年1月9日发布了微信的JS-SDK,详细接口可以参考:见微信JS-SDK说明文档 由于微信官方的接口互相独立,但是在事件使用中,我们可能会是很多接口一起使用,所以直接使用官方的接口比较麻烦,重复代码相对较多。为了更方便的使用,我对官方的接口进行了简单的封装,并开源处理,方便大家使用。
快速使用
1、引入js文件 由于该接口是对微信官方js的封装,需要同时引入微信官方的js-sdk文件和JWeixinApi的js文件。引入如下两个文件:
在需要调用JS接口的页面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.4.0.js
WeixinApi.js
2、通过config接口注入权限验证配置 该步骤和官方文档一样,详情微信JS-SDK说明文档
wx.config({ debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。 appId: '', // 必填,公众号的唯一标识 timestamp: , // 必填,生成签名的时间戳 nonceStr: '', // 必填,生成签名的随机串 signature: '',// 必填,签名,见附录1 jsApiList: [] // 必填,需要使用的JS接口列表,所有JS接口列表见附录2 });
3、通过ready接口处理成功验证
wx.ready(function(){ // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。 });
4、分享功能
wx.ready(function(){ // 初始化wx对象 WeixinApi.ready(wx); // 微信分享的数据 var wxData = { "imgUrl" : "http://www.jiayouxiaogui.cn/images/logo.png",// 分享图标 "link" : "http://www.jiayouxiaogui.cn", //分享链接 "desc" : "家有小鬼", //分享描述 "title" : "家有小鬼" // 分享标题 }; // 分享的回调函数 var wxCallbacks={ success:function(res){ // 用户确认分享后执行的回调函数 alert("success"); } }; // 用户点开右上角popup菜单后,点击分享给好友,会执行下面这个代码 WeixinApi.shareToFriend(wxData, wxCallbacks); // 点击分享到朋友圈,会执行下面这个代码 WeixinApi.shareToTimeline(wxData, wxCallbacks); }
5、隐藏右上角option menu入口
wx.ready(function(){ //隐藏右上角的option menu WeixinApi.hideOptionMenu(); //显示 //WeixinApi.showOptionMenu(); //批量隐藏功能按钮接口 //WeixinApi.hideMenuItems(); //批量显示功能按钮接口 //WeixinApi.showMenuItems(); //隐藏所有非基础按钮接口 //WeixinApi.hideAllNonBaseMenuItem(); //显示所有功能按钮接口 //WeixinApi.showAllNonBaseMenuItem(); }
6、隐藏底部工具栏
wx.ready(function(){ // 隐藏 WeixinApi.hideToolbar(); // 显示 // WeixinApi.showToolbar(); }