DIV CSS 佈局教程網

用 jQuery scroll 事件監控捲動到底部並自動載入下一頁
編輯:JQuery特效代碼     

無限捲動分頁的做法是:監聽捲動事件,判斷是否已接近頁面底部,若是則發出請求載入下一批資料。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() 的差別

這是整段程式碼的關鍵,兩者常被混用:

$(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 鎖並提示使用者重試。這兩點是無限捲動最容易缺少、卻最影響體驗的部分。

另外從無障礙角度,純捲動載入的內容對鍵盤使用者不友善(沒有明確的「更多」入口),實務上通常會在底部保留一個「載入更多」按鈕作為後備路徑。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved