DIV CSS 佈局教程網

用 JavaScript 修改網址參數的實作與改良
編輯:關於JavaScript     

需要在不重新載入頁面的情況下更新網址列參數時(例如分頁、篩選條件),就得手動處理 query string。以下是手寫實作,後面附上更簡潔的現代寫法。

function changeURLPar(url, ref, value) {
    var str = "";
    if (url.indexOf('?') != -1)
        str = url.substr(url.indexOf('?') + 1);
    else
        return url + "?" + ref + "=" + value;

    var returnurl = "";
    var setparam = "";
    var arr;
    var modify = "0";

    if (str.indexOf('&') != -1) {
        arr = str.split('&');
        for (i in arr) {
            if (arr[i].split('=')[0] == ref) {
                setparam = value;
                modify = "1";
            }
            else {
                setparam = arr[i].split('=')[1];
            }
            returnurl = returnurl + arr[i].split('=')[0] + "=" + setparam + "&";
        }
        returnurl = returnurl.substr(0, returnurl.length - 1);
        if (modify == "0")
            if (returnurl == str)
                returnurl = returnurl + "&" + ref + "=" + value;
    }
    else {
        if (str.indexOf('=') != -1) {
            arr = str.split('=');
            if (arr[0] == ref) {
                setparam = value;
                modify = "1";
            }
            else {
                setparam = arr[1];
            }
            returnurl = arr[0] + "=" + setparam;
            if (modify == "0")
                if (returnurl == str)
                    returnurl = returnurl + "&" + ref + "=" + value;
        }
        else
            returnurl = ref + "=" + value;
    }
    return url.substr(0, url.indexOf('?')) + "?" + returnurl;
}

程式在做什麼

流程是:切出問號後面的 query string → 依是否有 & 分成「多參數」與「單參數」兩支 → 逐段比對 key,找到就替換值並標記 modify,找不到就原樣保留 → 最後若從頭到尾都沒找到目標 key,就把它附加到最後 → 拼回完整網址。

這個實作的問題

邏輯大致正確,但細節有不少坑:

  • 沒有 URL 編碼。value 若含中文、空格或 &,產生的網址會壞掉。必須用 encodeURIComponent(value),讀取時也要 decodeURIComponent。
  • 用 == 比較而非 ===,key 比對時可能出現型別混淆。
  • for...in 遍歷陣列。會列出原型鏈屬性,且不保證順序。應該用一般的 for 迴圈。
  • i 漏宣告 var,成為全域變數。
  • 值含等號時出錯。arr[i].split('=')[1] 只取第一個等號後的第一段,base64 結尾的 = 會導致值被截斷。應該只切第一個等號。
  • modify 的判斷條件很奇怪。if (returnurl == str) 這個條件在正常情况下幾乎不可能成立,因為 returnurl 已經過重組。原意應該是「若 flag 未設置則附加」,條件寫錯了。
  • 單參數分支的 split('=') 在有多個等號時同樣會出錯。

現代寫法

這個需求現在有標準 API,幾行就能搞定,而且自動處理編碼:

function changeURLPar(url, key, value) {
    var u = new URL(url, window.location.origin);
    u.searchParams.set(key, value);
    return u.toString();
}

// 使用
var newUrl = changeURLPar('https://example.com/page?a=1&b=2', 'page', '3');
// => https://example.com/page?a=1&b=2&page=3

URLSearchParams.set() 的語意正是我們要的:key 存在就覆蓋,不存在就新增,不必自己維護 modify 旗標。它還會自動處理編碼、正確保留含等號的值。

若要直接改變目前頁面的網址而不重新載入,搭配 History API:

var u = new URL(window.location.href);
u.searchParams.set('page', '2');
history.replaceState(null, '', u);   // 替換目前項目,不新增歷史紀錄

// 若希望使用者能按返回回到上一個篩選狀態,改用 pushState
history.pushState(null, '', u);

用 replaceState 還是 pushState 取決於語意:分頁這種「同一頁的不同檢視」通常用 replace 避免塞爆歷史紀錄;篩選條件這種「使用者會想往回退」的情境則該用 push。選錯會讓返回鍵行為變得莫名其妙,這是實務上很常被忽略的一點。

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