單頁應用裡,頁面不重新載入卻要讓網址反映當前狀態,是很常見的需求。這可以透過改寫查詢參數,或更輕量的方式——修改 hash 來達成。
目標:給定一個 URL、參數名與新值,若該參數已存在就替換,不存在就追加。
function changeURLPar(destiny, par, par_value) {
var pattern = par + '=([^&]*)';
var replaceText = par + '=' + par_value;
if (destiny.match(new RegExp(pattern))) {
// 已存在,替換其值
return destiny.replace(new RegExp('\\' + par + '=[^&]*'), replaceText);
} else {
// 不存在,依情況追加
if (destiny.match('[?]')) {
return destiny + '&' + replaceText;
} else {
return destiny + '?1=1&' + replaceText;
}
}
}
// 使用
changeURLPar('https://example.com/page?a=1&b=2', 'b', '99');
// → "https://example.com/page?a=1&b=99"
原始寫法用 eval_r 動態組字串再 eval,這裡改用 new RegExp(),功能相同但更安全清楚。另外要提醒:這個實作沒有處理 hash 片段(#...)與參數名的正則轉義,正式使用前建議補上;若只是要在瀏覽器端更新當前網址,下面的現代寫法會更省事。
window.location.hash 的關鍵特性是:修改它不會導致頁面重新載入,也不會送出請求,瀏覽器只會在網址後加上 # 與新值。
// 讀取
console.log(location.hash); // "#section2"
// 設定
location.hash = 'section2';
// 也可以直接指定完整 hash
location.hash = '#/user/123/settings';
這帶來兩個實用價值:
一、無刷新的位置記錄。Ajax 載入不同內容時,把當前狀態寫進 hash,使用者重新整理或按上一頁時仍能回到同一狀態。同時 hashchange 事件可以讓你響應網址變化:
window.addEventListener('hashchange', function () {
var route = location.hash.slice(1);
renderView(route);
});
二、純前端的視覺效果。錨點跳轉、分步驟引導、 accordion 展開狀態等,都能靠 hash 保存與還原。
如果目標是「改網址但不重整」,現在更推薦 history.pushState,因為它能改寫真正的路徑而非只有 hash:
// 新增一筆歷史紀錄,網址變為 /user/123,但不會重新載入
history.pushState({ userId: 123 }, '', '/user/123');
// 替換當前紀錄(不新增上一頁)
history.replaceState(null, '', '/user/123?tab=info');
// 監聽返回/前進
window.addEventListener('popstate', function (event) {
console.log(event.state);
});
差別在於:hash 的變化會產生 hashchange 事件且永遠不會傳到伺服器;pushState 改的是真實路徑,需要伺服器端配合把所有路徑都導回同一份 HTML,並以 popstate 取代 hashchange 來監聽。
選擇很簡單:只是頁內錨點或簡單狀態記錄,用 hash 最省事;要建立有 SEO 需求或層級清楚的分享連結,就用 history API。