DIV CSS 佈局教程網

把「取得網址 GET 參數」封裝成 jQuery 擴充方法
編輯:JavaScript綜合知識     

需求

純前端處理時常有一個場景:要把目前頁面的某個參數透傳給下一頁。做法就是從 window.location.href 把查詢字串拆出來。與其每次重寫一次解析邏輯,不如把它掛到 jQuery 上,變成 $.urlGet() 這樣全域可用的工具。

核心思路

整個流程只有三步:用 ? 把網址切成「主體」與「查詢字串」兩半,再用 & 把查詢字串切成一組 key=value,最後用 = 把每一組再切成鍵與值,塞進一個物件裡回傳。

完整程式碼

/**
 * jQuery url get parameters function [取得 URL 的 GET 參數值]
 * @character_set UTF-8
 * @author Jerry.li (lijian@dzs.mobi)
 * @version 1.2012.12.11.1400
 *
 * 用法:
 * var GET = $.urlGet();   // 取得 URL 的所有 Get 參數
 * var id  = GET['id'];    // 取出 id 的值
 */
;(function ($) {
    $.extend({
        /**
         * url get parameters
         * @public
         * @return array()
         */
        urlGet: function () {
            var aQuery = window.location.href.split("?");   // 取得 Get 參數
            var aGET = new Array();
            if (aQuery.length > 1) {
                var aBuf = aQuery[1].split("&");
                for (var i = 0, iLoop = aBuf.length; i < iLoop; i++) {
                    var aTmp = aBuf[i].split("=");          // 分離 key 與 Value
                    aGET[aTmp[0]] = aTmp[1];
                }
            }
            return aGET;
        }
    });
})(jQuery);

幾個細節說明

開頭那個 ; 不是多餘的。前面若有其他函式庫或壓縮過的腳本少了分號結尾,直接寫 (function($){...}) 會被解析成呼叫前一個運算式而炸掉,加個分號隔開是最保險的習慣。

整個程式包在 IIFE 裡並把 jQuery 傳進來當作 $,這樣即使頁面其他函式庫佔用了 $,這段程式裡的 $ 依然安全指向 jQuery。

if (aQuery.length > 1) 這個判斷很重要:網址沒帶參數時 split("?") 只會得到一個元素,此時直接回傳空陣列,避免後續 aQuery[1] 是 undefined 而報錯。

這個版本還缺什麼

沒有做 URL 解碼。參數值如果被編碼過(例如中文變成 %E4%B8%AD%E6%96%87),拿到的就是編碼後的字串。應該補上 decodeURIComponent:

aGET[aTmp[0]] = decodeURIComponent(aTmp[1] || '');

值裡含 = 會被截斷。split("=") 遇到 ?url=https://x.com?a=1 這種巢狀參數時會切好幾段。比較穩健的寫法是限制切一刀:

var idx = aBuf[i].indexOf("=");
var key = aBuf[i].substring(0, idx);
var val = aBuf[i].substring(idx + 1);

不要忘了 hash。如果是 page.html?a=1#section,最後一段的值會帶著 #section,需要先把 location.hash 去掉再解析。

現代替代方案

今天的瀏覽器都支援 URLSearchParams,同樣的需求只要一行:

var id = new URLSearchParams(location.search).get('id');

它自動處理解碼、重複參數與空值,也不必依賴 jQuery。封裝成 jQuery 擴充的寫法在當時很優雅,但如果是新專案,直接用原生 API 會更省事也更可靠。

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