需要在不重新載入頁面的情況下更新網址列參數時(例如分頁、篩選條件),就得手動處理 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,就把它附加到最後 → 拼回完整網址。
邏輯大致正確,但細節有不少坑:
&,產生的網址會壞掉。必須用 encodeURIComponent(value),讀取時也要 decodeURIComponent。arr[i].split('=')[1] 只取第一個等號後的第一段,base64 結尾的 = 會導致值被截斷。應該只切第一個等號。if (returnurl == str) 這個條件在正常情况下幾乎不可能成立,因為 returnurl 已經過重組。原意應該是「若 flag 未設置則附加」,條件寫錯了。這個需求現在有標準 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。選錯會讓返回鍵行為變得莫名其妙,這是實務上很常被忽略的一點。