DIV CSS 佈局教程網

用 JavaScript 修改網址參數:一個函式搞定增、改、查
編輯:JavaScript綜合知識     

需要在不重新載入的前提下改寫目前網址的 query string,例如切換頁碼、篩選條件時同步更新網址——這件事在 ES6 之前得自己解析字串,現在則有標準 API 可用。兩種做法都記錄在這裡。

傳統做法:手動解析與重組

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

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

    if (str.indexOf('&') != -1) {
        arr = str.split('&');
        for (var 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;
}

這個寫法能動,但有幾個弱點:值裡若含 &、= 或中文會解析錯誤(未做 encode/decode);用 for...in 走訪陣列會把額外掛上去的屬性也算進來;用「modify 是否等於 0」這種字串旗標來判斷有沒有改到,可讀性偏低。

現代做法:URL 與 URLSearchParams

這兩個是標準 Web API,所有支援 ES6 以上的瀏覽器與 Node.js 都能用:

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

// 使用
var newUrl = changeURLPar("list.aspx?page=2&size=20", "page", 3);
// → https://.../list.aspx?page=3&size=20

set() 的行為剛好符合需求:參數不存在就新增,已存在就覆寫,而且會自動處理編碼。其他好用的方法:

u.searchParams.get("page");      // 讀取
u.searchParams.has("page");      // 是否存在
u.searchParams.append("tag", "x"); // 追加(允許重複鍵)
u.searchParams.delete("page");   // 刪除
u.searchParams.toString();       // 全部轉成 query 字串

改寫「目前網址」而不是回傳字串

實務上更常見的需求是直接更新瀏覽器網址列,且不觸發重新載入:

// 不新增歷史紀錄(取代目前這筆)
history.replaceState(null, "", changeURLPar(location.href, "page", 3));

// 新增一筆歷史紀錄,使用者可按上一頁回到先前的篩選狀態
history.pushState(null, "", changeURLPar(location.href, "page", 3));

如果希望「上一頁」按鈕也能還原對應的頁面狀態,要記得監聽:

window.addEventListener("popstate", function () {
    var page = new URLSearchParams(location.search).get("page");
    loadData(page);
});

如果只想改一個已知參數

不需要整個函式時,直接操作即可:

var p = new URLSearchParams(location.search);
p.set("page", 3);
history.pushState(null, "", "?" + p.toString());

比起手寫字串切割,這三行更短、更安全,也不會漏掉 URL 編碼——這是標準 API 值得優先採用的典型例子。

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