AJAX 讓我們能在不重新載入的前提下更新頁面內容,但網址列永遠停在原來那一頁——使用者按上一頁會直接離開網站,分享出去的連結也對不上畫面。HTML5 的 History API 正是為了解決這個落差而生。
window.history 代表目前這個頁籤的瀏覽歷史記錄,而 HTML5 為它加了兩個可以「寫入」的 method:
window.history.pushState(object, title, new_url);
呼叫後會在歷史堆疊上「疊」一個新項目,網址列換成 new_url,但頁面不會重新載入。使用者按上一頁時,會回到呼叫前的狀態,並觸發 popstate 事件。
window.history.replaceState(object, title, new_url);
差別只在於它把「目前這一筆」換掉,而不是新增一筆。適合用在正規化網址(例如把 ?ref=abc 清乾淨),因為按上一頁不會多出一個無意義的狀態。
popstate 事件的 event.state 取回。放什麼都可以,例如目前的分頁、篩選條件、捲動位置。document.title。// 原始網址:https://www.test.com/
window.history.pushState({ time: 'test' }, '', 'www.test_test.com');
// 稍後在 popstate 中取回狀態
window.addEventListener('popstate', function (e) {
if (e.state) {
console.log(e.state.time); // => 'test'
}
});
pushState 只改網址,不會抓內容。所以後端必須準備好:使用者若直接開啟或重新整理 /user/42 這個路徑,伺服器要能回傳同一個單頁應用程式入口,而不是 404。這是採用 HTML5 history 模式(相對於 hash 模式)時最典型的部署陷阱。
另外,popstate 是你的「資料同步點」:使用者按上一頁/下一頁時,頁面不會重新載入,因此必須在這個事件裡依 event.state 把畫面還原成對應的樣子。少了這一步,網址變了、畫面卻沒動,體驗反而比不做更糟。