「點頁碼局部更新內容,並且能正常按上一頁/下一頁」——這個需求幾乎每個列表頁都會遇到。局部刷新用 Ajax 就能搞定,但它不會產生歷史紀錄。HTML5 的 History API 正是為了解決這落差而生。
pushState() 接受三個參數:
history.pushState(state, title, url);
它的作用是:把目前的 URL 與 state 一併壓入 history 堆疊,並用新的 state 與 URL 取代目前項——且不會造成頁面刷新。
replaceState() 用法相同,差別在於它修改的是「目前」這一筆歷史紀錄,而非新增一筆。
history.replaceState(state, title, url);
window.onpopstate:當使用者觸發 history.go、history.back 或按下瀏覽器的前進後退鍵時就會發生。由於 pushState 改動了 history,因此頁面不刷新的情況下也會觸發此事件;此時瀏覽器會從 history 取出對應的 URL 與 state 物件。透過 event.state 也能取得同一份資料。
場景:點擊頁碼,下方區域出現不同的圖片與標題,以 Ajax 更新,同時產生歷史紀錄。
<p class="page">
<a href="javascript:;">[ <span>1</span> ]</a>
<a href="javascript:;">[ <span>2</span> ]</a>
<a href="javascript:;">[ <span>3</span> ]</a>
<a href="javascript:;">[ <span>4</span> ]</a>
</p>
<div>
<img />
<p class="title"></p>
</div>
每次點擊就寫入一筆歷史:
function setUrl(page) {
var url = location.pathname + '?page=' + page;
history.pushState({ url: url }, '', url);
}
首次載入時,記得先把目前這筆歷史「正規化」成帶參數的形式:
(function () {
var url = location.pathname + '?page=1';
history.replaceState({ url: url }, '', url);
})();
接著監聽 popstate,在事件發生時取出頁碼並重新請求:
window.addEventListener('popstate', function () {
var page = getPage();
xhr(page);
});
後端必須能處理帶參數的請求。使用者按 F5 重新整理或直接分享該網址時,瀏覽器會真的向伺服器請求 ?page=3。若伺服器回 404,整套機制就等於半殘。請確認對應路由存在,或至少回傳同一份頁面骨架再由前端依參數渲染。
state 裡存最小必要資訊。它可以存資料本身,也可以只存一個識別碼,於 popstate 時再發請求補齊。前者速度快但資料新鮮度較差,後者永遠拿到最新內容,可依場景取捨。
整體骨架就是這樣:點擊時 pushState 加 Ajax 更新畫面,popstate 負責把歷史狀態還原回畫面。兩者搭配,使用者既能享受無刷新的流暢,又保有對瀏覽器導覽的掌控。