無限捲動分頁的做法是:監聽捲動事件,判斷是否已接近頁面底部,若是則發出請求載入下一批資料。jQuery 的 scroll 事件讓這件事變得很簡短。
scroll 事件適用於 window 物件,也可以用於可捲動的 iframe,以及 CSS 設為 overflow:scroll 的元素。
$(document).ready(function () {
$(window).scroll(function () {
// 目前捲動的距離
var scrollTop = $(window).scrollTop();
// 視窗可見區域高度
var winHeight = $(window).height();
// 整個文件的總高度
var docHeight = $(document).height();
var bot = 50; // 預留 50px 緩衝區,提早觸發載入
if ((bot + scrollTop) >= (docHeight - winHeight)) {
// 該去異步載入下一頁了
$.getJSON("url", { page: "2" }, function (str) { alert(str); });
}
});
});
這是整段程式碼的關鍵,兩者常被混用:
$(window).height() 目前可見區域的大小,也就是瀏覽器視窗一眼能看到的那部分高度。當使用者縮放視窗(最大化、拉高)時,這個值會跟著改變。
$(document).height() 整個文件的總高度,包含需要捲動才能看到的部分。縮放視窗不會改變它。
所以判斷式 scrollTop + winHeight >= docHeight 的意義是:「已捲過的距離加上一屏的高度,已經覆蓋整個文件」,也就是捲到底了。
$(document).scrollTop() // 垂直捲動距離
$(document).scrollLeft() // 水平捲動距離
// 是否已到頂端
if ($(document).scrollTop() === 0) { /* 在頂端 */ }
// 是否已到底端
if ($(document).scrollTop() >= $(document).height() - $(window).height()) { /* 到底了 */ }
自己動手印一次值最能把這些概念記起來:
$(document).scroll(function(){
$("#lb").text($(document).scrollTop());
});
<span id="lb" style="top:100px; left:100px; position:fixed;"></span>
把 span 設為 position:fixed,捲動時它就固定在畫面上,方便隨時查看目前的 scrollTop 數值。
節流(throttle)。scroll 事件的觸發頻率極高,一秒內可能上百次,每次都執行判斷會明顯拖慢捲動流暢度。建議用 requestAnimationFrame 或 100~200ms 的節流包裝處理函數。
防止重複請求。範例中只要條件成立就會發請求,若使用者停在底部不動,可能連續送出好幾次相同的要求。加上旗標鎖住:
var loading = false;
$(window).scroll(function(){
if (loading) return;
if ($(window).scrollTop() + $(window).height() >= $(document).height() - 50) {
loading = true;
$.getJSON("/api/list?page=" + (++page)).done(function(){
// append 資料
}).always(function(){ loading = false; });
}
});
處理結尾與錯誤。載到最後一頁時必須停止請求並顯示「沒有更多了」,請求失敗則要解除 loading 鎖並提示使用者重試。這兩點是無限捲動最容易缺少、卻最影響體驗的部分。
另外從無障礙角度,純捲動載入的內容對鍵盤使用者不友善(沒有明確的「更多」入口),實務上通常會在底部保留一個「載入更多」按鈕作為後備路徑。