如何使用jQuery.wechat构建微信WEB应用

如何使用jquery.wechat构建微信web应用众所周知，腾讯是那样一个神奇的公司，他们的产品在商业上获得巨大成功，但文档真的很难令人恭维，诺大一个公众号开发平台，我竟然找不到真正的，关于web开发的官方文档，有的就是个别示例，剩下的...呵呵，有一个叫开发者交流互助的东东。

看完上面这个图后，有没有这样的感觉，一帮群众拼命的想知道发生了什么，但就是没有官方声明！o(∩_∩)o 哈哈

说了这么多，赶紧入正题，本期要讲的就是我痛苦中挣扎徘徊后写的jquery.wechat，一个提供了统一api的、基于jquery.promise的jquery.plugin。希望能多少帮助到大家。

首先，安装那是相当的简单

代码如下:

bower install --save jquery-wechat

 

 如果不用bower的，自己从github上下载、解压，那也是一样一样滴！
 
加载，那也是水一样的自然

代码如下:

<script type="text/javascript" src="bower_components/jquery/dist/jquery.min.js"></script>
<script type="text/javascript" src="bower_components/jquery-wechat/dist/jquery-wechat.min.js"></script>

 

 你如果用了amd，cmd之类的延迟加载技术，想必你也是个行家，不用我再教你怎么配置了吧？
 
使用——简单、轻松、统一、爽！

启用jquery.wechat功能
$.wechat.enable(); //so easy!

 因为整个插件是基于jquery.promise的，所以你也可以给它一个链：

 

代码如下:

$.wechat.enable().done(function(){
    alert('已经启用成功');
}).fail(function(){
    alert('启用失败');
});

 

 考虑到目前单页技术(spa)的广泛应用，工具类的设计必须考虑启用/停用机制，否则可能引起未知错误。
 
隐藏/显示菜单

代码如下:

$.wechat.hidemenu(); //隐藏菜单
$.wechat.showmenu(); //显示菜单

 

 启用jquery.wechat之后，就可以随意调用如hidemenu之类的方法了，无需将其他方法写入enable的done回调之中。jquery.wechat的实现原理是，如果jquery.wechat还没有启用成功，所有操作会进入排队，一旦启用成功后，则顺序执行；如果启用失败，则永远不会执行。
 
隐藏/显示底部工具栏
$.wechat.hidetoolbar(); //隐藏底部工具栏
$.wechat.showtoolbar(); //显示底部工具栏

 打开扫描二维码界面
$.wechat.scanqrcode();

 打开图片预览工具

代码如下:

$.wechat.preview({
    current: 'https://xxx/img/pic001.jpg',  //进入预览模式后，直接显示这张图片
    urls: [
        'https://xxx/img/pic001.jpg',
        'https://xxx/img/pic002.jpg',
        'https://xxx/img/pic003.jpg',
        'https://xxx/img/pic004.jpg',
        'https://xxx/img/pic005.jpg',
        'https://xxx/img/pic006.jpg'
    ]                                      //所有要在预览模式下显示的图片
});

 

 获取网络状态

代码如下:

$.wechat.getnetworktype().done(function(response) {
    $('#network').text(response.split(':')[1]);
});

 

response格式如下：

代码如下:

network_type:wifi    wifi网络
network_type:edge    非wifi,包含3g/2g
network_type:fail    网络断开连接
network_type:wwan    (2g或者3g)

 

 修改分享格式

每次看到别人的app分享出来的消息都带着精美的缩略图、适当的标题和描述，更有甚者消息下面还跟了一行小字指出该消息是由谁发送出来的；再看看你自己分享出去的消息，一个蓝色的默认空白图片，配着不搭调的标题，会不会奇怪是什么逻辑把他们塞进去的？

还好，咱们现在就来解决这个问题:

代码如下:

$.wechat.setshareoption({
    appid: 'xxxx',                                               //小标appid
    img_width: '60',
    img_height: '60',
    img_url: window.location.tostring() + 'img/demo.jpg',        //缩略图
    title: 'demo',                                               //标题
    desc: 'the description is set from $.wechat.setshareoption', //描述
    link: function() {
        return window.location.tostring();                       //消息分享出去后，用户点击消息打开的链接地址
    },
    callback: function(response) {
        alert(response);                                         //分享后的回调函数，常见的有成功和取消
    }
});

 

 具体参考如下截图：

该分享格式变更会影响发送给朋友、分享到朋友圈、分享到微博、发送邮件四项功能。当设置后，再点击右上角菜单键打开菜单后，选择前述四项中的任意一项，就能看到更改后的效果
 
关闭当前页

代码如下:

$.wechat.closewindow();

 

 停用jquery.wechat机制

代码如下:

$.wechat.destroy();

 

 停用后，所有功能自动重置回初始状态，该功能在单页应用(spa)中比较常用。