分頁跳轉、多條件查詢、篩選排序——這些功能都需要在網址上增刪參數。與其每次手寫字串拼接,不如封裝一個函式。以下是思路與實作。
取得當前網址相關資訊,其實有現成的內建屬性:
<script type="text/javascript">
thisURL = document.URL;
thisHREF = document.location.href;
thisSLoc = self.location.href;
thisDLoc = document.location;
strwrite = " thisURL: [" + thisURL + "]<br>"
strwrite += " thisHREF: [" + thisHREF + "]<br>"
strwrite += " thisSLoc: [" + thisSLoc + "]<br>"
strwrite += " thisDLoc: [" + thisDLoc + "]<br>"
document.write(strwrite);
</script>
這幾個寫法在大多數情況下回傳相同的值,但語意與可靠性略有差異。document.location 在舊 IE 有已知的問題,實務上以 window.location.href 最穩妥。
思路很直接:先把網址拆成「主體」與「參數串」,把參數串按 & 切成陣列,逐項檢查是否為要改的參數,改完再拼回去。
//=============== 改變網址的參數值 ================
function ChangeURLParm(Turl, Parm, PValue, ClearParm) {
// Turl:網址 Parm:要改的參數
// PValue:新的參數值 ClearParm:要清空的參數
var URL, Parms, ParmsArr, IsExist;
var NewURL = Turl;
IsExist = false;
with (Turl) {
if (indexOf('?') > 0) {
URL = substr(0, indexOf('?')); // 不含參數的主體
Parms = substr(indexOf('?') + 1); // 參數部分
} else {
URL = Turl;
Parms = '';
}
}
if (Parms != '') {
var i;
ParmsArr = Parms.split("&");
for (i = 0; i <= ParmsArr.length - 1; i++) {
if (String(Parm).toUpperCase() == String(ParmsArr[i].split("=")[0]).toUpperCase()) {
// 原本就有這個參數,改它的值
ParmsArr[i] = Parm + "=" + PValue;
IsExist = true;
if (String(ClearParm) == "") { break; }
} else if ((String(ClearParm) != "") &&
(String(ClearParm).toUpperCase() == String(ParmsArr[i].split("=")[0]).toUpperCase())) {
// 清空指定參數的值
ParmsArr[i] = ClearParm + "=";
}
}
// 把陣列拼回字串
for (i = 0; i <= ParmsArr.length - 1; i++) {
if (i == 0) { Parms = ParmsArr[i]; } // 第一項不加 &
else { Parms = Parms + "&" + ParmsArr[i]; }
}
NewURL = URL + "?" + Parms;
if (!IsExist) {
NewURL = NewURL + "&" + Parm + "=" + PValue; // 原本沒有,附加上去
}
} else {
NewURL = URL + "?" + Parm + "=" + PValue;
}
return NewURL;
}
三個分支涵蓋了所有情況:參數已存在就改值、原本沒有就附加、完全沒有查詢字串就直接建立第一個。這種「窮舉所有狀態」的結構是寫工具函式時該有的態度。
實際應用上很好使,尤其在分頁跳轉與多條件查詢搜尋中——使用者點「第 2 頁」時保留原本的篩選條件,或勾選新條件時重設頁碼,都靠它。
用 with 陳述句是壞習慣。with(Turl){ indexOf(...) } 讓程式碼變短,但它在 strict mode 下直接是語法錯誤,而且會讓作用域解析變得難以追蹤,是公認該避免的寫法。改成 Turl.indexOf('?') 就好,長度差不多。
沒有做 URL 編碼。PValue 若含中文、空格或 &,直接拼上去會產生無效網址。必須 encodeURIComponent(PValue)。
用 toUpperCase 做不分大小寫比較,是錯的。參數名稱在標準中是有大小寫之分的,?ID=1 與 ?id=1 是兩個不同的參數。這裡把它們視為相同,會造成難以察覺的錯誤。
值裡含 = 時會出錯。split("=")[0] 取等號左邊是對的,但 base64 編碼的值常以 = 結尾(例如 ?token=abc==),這裡的比對邏輯沒有處理這種情況。
fragment 沒被考慮。若網址是 page.php?id=1#section,這裡會把 section 當成參數值的一部分。應該先切掉 # 後面再處理。
這個需求現在有標準 API,而且簡短得多:
function changeUrlParam(url, key, value) {
var u = new URL(url, window.location.origin);
u.searchParams.set(key, value);
return u.toString();
}
// 清空的話用 delete
function removeUrlParam(url, key) {
var u = new URL(url, window.location.origin);
u.searchParams.delete(key);
return u.toString();
}
URL 與 URLSearchParams 幫你處理了編碼解碼、fragment 隔離、重複參數、以及各種邊界情況,程式碼也短到不需要註解。
若要直接改當前網址而不重新載入頁面:
const u = new URL(window.location.href);
u.searchParams.set('page', '3');
window.history.replaceState({}, '', u); // 不新增歷史紀錄
// 或 pushState 讓使用者可以用「上一頁」回到前一個狀態
選 replaceState 還是 pushState 是個設計決定:篩選條件的變更通常用 replaceState(不想讓按上一頁變成層層返回),而分頁翻頁通常用 pushState(使用者會期待能往回翻)。
自己寫一遍仍然有價值——它讓你理解查詢字串的結構,而這個理解在處理 API、除錯、或需要解析非標準格式的時候都用得上。但正式專案請用標準 API。