需要在不重新載入的前提下改寫目前網址的 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」這種字串旗標來判斷有沒有改到,可讀性偏低。
這兩個是標準 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 值得優先採用的典型例子。