DIV CSS 佈局教程網

用 jQuery 打造類 C# 風格的網址參數讀取插件 $.request
編輯:JQuery特效代碼     

在 JavaScript 裡解析 query string 一直是件瑣事:要處理 ?、要處理 &、還要做 URL 解碼。這個小插件把這件事收攏成一個 $.request 介面,寫法刻意模仿 C# 的 Request 物件,讀起來非常直覺。

$.request = (function () {
    var apiMap = {};                       // 以 query string 為 key 的快取

    function request(queryStr) {
        var api = {};
        if (apiMap[queryStr]) { return apiMap[queryStr]; }

        api.queryString = (function () {
            var urlParams = {};
            var e,
                d = function (s) { return decodeURIComponent(s.replace(/\+/g, " ")); },
                q = queryStr.substring(queryStr.indexOf('?') + 1),
                r = /([^&=]+)=?([^&]*)/g;

            while (e = r.exec(q)) {
                urlParams[d(e[1])] = d(e[2]);
            }
            return urlParams;
        })();

        api.getUrl = function () {             // 把參數重新拼回成完整網址
            var url = queryStr.substring(0, queryStr.indexOf('?') + 1);
            for (var p in api.queryString) {
                url += p + '=' + api.queryString[p] + "&";
            }
            if (url.lastIndexOf('&') == url.length - 1) {
                return url.substring(0, url.lastIndexOf('&'));
            }
            return url;
        };

        apiMap[queryStr] = api;                // 寫入快取
        return api;
    }

    $.extend(request, request(window.location.href));  // 預先綁定目前網址
    return request;
})();

設計上有兩個細節值得注意。第一是 replace(/\+/g, " "):查詢字串裡的加號代表空格,不解掉就會讓字串內容多出莫名的 + 號。第二是 apiMap 快取,同一組 query string 第二次呼叫時直接回傳既有物件,省下重複解析的正則開銷。

取得目前網址的參數

因為最後那行 $.extend(request, request(window.location.href)),所以當前頁面的參數可以直接用點號或索引取值:

var id = $.request.queryString["id"];
var name = $.request.queryString.name;

更實用的一招:把設定寫在 HTML 標籤上

這個插件真正的價值在於——它可以解析任何字串,不侷限於瀏覽器網址列。我們常在標籤上掛一些非標準屬性來當作設定旗標,例如:

<a id="demo" href="javascript:;" config="?title=hello&auto=true&">Demo</a>

要讀取時,把該屬性的值丟給 $.request() 就完成了:

var config = $.request($("#demo").attr("config")).queryString;
var title  = config.title;   // "hello"
var auto   = config.auto;    // "true"

這種做法的好處是:不必為了一兩個設定而替元素加上五六個自訂屬性,一個 config 字串就能承載任意數量的參數,後端輸出 HTML 時也更好控制。我自己大多數時候就是拿它來讀這類配置資訊。

一個提醒

要注意 queryString 取出的值一律是字串,"true" 不會自動變成布林 true,"3" 也不會變成數字 3。需要型別時記得自己轉換,例如 config.auto === "true" 或 parseInt(config.page, 10)。

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