DIV CSS 佈局教程網

用 jQuery.wechat 輕鬆建構微信網頁應用
編輯:JavaScript綜合知識     

不可否認,騰訊的產品在商業上非常成功,但官方文件卻常讓開發者叫苦——想在一大堆公眾號資料裡找到真正完整的 Web 開發文件,往往只能翻到零散的示例。就在這樣的處境下,作者寫出了 jQuery.wechat,一個提供統一 API、基於 jQuery.promise 的外掛,希望多少幫到大家。

安裝與載入

安裝相當簡單,一行 bower 指令即可:

bower install --save jquery-wechat

不用 bower 的話,直接從 GitHub 下載解壓也一樣。載入時依序引入 jQuery 與外掛本身:

<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>

啟用與鏈式呼叫

啟用只要一行:$.wechat.enable();。因為整個外掛基於 promise,你也可以串起鏈:

$.wechat.enable().done(function(){
    alert('已經啟用成功');
}).fail(function(){
    alert('啟用失敗');
});

考量到單頁應用(SPA)的普及,工具類的設計必須具備啟用/停用機制。啟用後,所有操作若尚未就緒會自動排隊,一旦啟用成功便依序執行;若失敗則永不執行。

常用方法一覽

隱藏/顯示菜單與底部工具欄:

$.wechat.hideMenu();
$.wechat.showMenu();
$.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'
]
});

取得網路狀態:

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

response 可能的格式有:network_type:wifi(無線網路)、network_type:edge(非 wifi,含 3G/2G)、network_type:fail(網路斷線)、network_type:wwan(2G 或 3G)。

自訂分享格式

當別人分享出來的消息有精美縮圖、標題與描述,而你卻只有一張空白藍圖時,就靠這段來扳回一城:

$.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() 關閉當前頁,以及 $.wechat.destroy() 停用整個機制。整體而言,這套外掛把繁瑣的微信 JS 介面包裝成直覺的鏈式呼叫,開發體驗相當順手。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved