專案要在前端頁面展示已購買商品,需求是「下拉加載更多」。網路上有現成外掛可用,例如以 iscroll.js 實作的上拉加載與下拉刷新,但實際用起來得完全照對方定義的介面走,加上它本身並未內建加載更多,需要自行擴充,反而綁手綁腳。H5 專案又只需要簡單的分頁,在行動端用「加載更多」顯然比 PC 端的翻頁頁碼合適得多。於是自己動手寫了兩版,並進一步抽成一個小外掛。
最直白的做法:放一顆「加載更多」按鈕,只要還有資料,點擊就再拉幾筆;直到沒有更多資料為止,把按鈕隱藏起來。

頁面結構:
<div class="content">
<div class="weui_panel weui_panel_access">
<div class="weui_panel_hd">文章列表</div>
<div class="weui_panel_bd js-blog-list"></div>
</div>
<!-- 加載更多按鈕 -->
<div class="js-load-more">加載更多</div>
</div>
<script src="js/zepto.min.js"></script>
按鈕樣式(loadmore.css):
@charset "utf-8";
.js-load-more{
padding:0 15px;
width:120px;
height:30px;
background-color:#D31733;
color:#fff;
line-height:30px;
text-align:center;
border-radius:5px;
margin:20px auto;
border:0 none;
font-size:16px;
display:none; /* 預設不顯示,ajax 成功後才決定是否顯示 */
}
JS 部分:
$(function(){
var counter = 0; // 計數器
var pageStart = 0; // offset
var pageSize = 4; // size
// 首次載入
getData(pageStart, pageSize);
// 監聽加載更多
$(document).on('click', '.js-load-more', function(){
counter++;
pageStart = counter * pageSize;
getData(pageStart, pageSize);
});
});
其中 getData(pageStart, pageSize) 是業務邏輯,負責向伺服器取資料:
function getData(offset, size){
$.ajax({
type: 'GET',
url: 'json/blog.json',
dataType: 'json',
success: function(reponse){
var data = reponse.list;
var sum = reponse.list.length;
var result = '';
/**** 業務邏輯:拼湊 html 並 append 到頁面 ****/
/* 若剩餘筆數不足一頁,就只取剩下的
例如每頁 5 筆、只剩 2 筆,就取 2 筆 */
if (sum - offset < size) {
size = sum - offset;
}
/* 用 for 迴圈模擬 SQL 的 limit(offset, size) */
for (var i = offset; i < (offset + size); i++){
result += '<div class="weui_media_box weui_media_text">'
+ '<a href="' + data[i].url + '" target="_blank">'
+ '<h4 class="weui_media_title">' + data[i].title + '</h4></a>'
+ '<p class="weui_media_desc">' + data[i].desc + '</p>'
+ '</div>';
}
$('.js-blog-list').append(result);
/* 沒有更多就隱藏按鈕 */
if ((offset + size) >= sum) {
$(".js-load-more").hide();
} else {
$(".js-load-more").show();
}
},
error: function(xhr, type){
alert('Ajax error!');
}
});
}
把觸發條件從點擊換成捲動,其他邏輯幾乎不變:
$(function(){
var counter = 0;
var pageStart = 0;
var pageSize = 7;
var isEnd = false; // 結束標記
getData(pageStart, pageSize);
$(window).scroll(function(){
if (isEnd == true) { return; }
// 核心判斷:捲到距底部 100px 以內時載入新內容
if ($(document).height() - $(this).scrollTop() - $(this).height() < 100) {
counter++;
pageStart = counter * pageSize;
getData(pageStart, pageSize);
}
});
});
業務邏輯裡只需把結尾判斷改成:
if ((offset + size) >= sum) {
isEnd = true; // 沒有更多了
}
這裡仍有可優化之處,例如:使用者捲動過快、伺服器還沒回應就連續觸發多次請求,該如何防止?
第二種體驗更好,但有個盲點:若每頁只顯示 2、3 筆(size=2),總共 20 筆時,頁面高度不足以產生捲動,就永遠觸發不到載入邏輯。這時候一顆「加載更多」按鈕剛好派上用場。
於是策略定為:預設用捲動觸發,當顯示數量太少而不足以產生捲動時,退回點擊觸發。把這個行為抽象出來,就得到下面的小外掛:
/*
* loadmore.js —— 加載更多
* @param callback 回呼函式
* @param config 自訂參數,可傳 size、scroll 等
*/
;(function(w, $){
var loadmore = {
get : function(callback, config){
var config = config ? config : {}; // 避免未傳參數報錯
var counter = 0;
var pageStart = 0;
var pageSize = config.size ? config.size : 10;
// 方式一:點擊加載更多
$(document).on('click', '.js-load-more', function(){
counter++;
pageStart = counter * pageSize;
callback && callback(config, pageStart, pageSize);
});
// 方式二:監聽捲動自動加載
config.isEnd = false; // 結束標記
config.isAjax = false; // 防止捲動過快造成重複請求
$(window).scroll(function(){
if (!config.scroll) { return; } // 未開啟捲動加載
if (config.isEnd == true || config.isAjax == true) { return; }
// 捲到距底部 100px 以內時載入
if ($(document).height() - $(this).scrollTop() - $(this).height() < 100) {
counter++;
pageStart = counter * pageSize;
callback && callback(config, pageStart, pageSize);
}
});
// 首次自動加載
callback && callback(config, pageStart, pageSize);
}
};
$.loadmore = loadmore;
})(window, window.jQuery || window.Zepto);
使用方式非常簡單:
$.loadmore.get(getData, {
scroll: true, // 預設 false,是否啟用捲動加載
size: 7, // 預設 10
flag: 1 // 自訂參數,可選
});
第一個參數是回呼函式,也就是業務邏輯本身。加上防重複請求的判斷後, getData 長這樣:
function getData(config, offset, size){
config.isAjax = true;
$.ajax({
type: 'GET',
url: 'json/blog.json',
dataType: 'json',
success: function(reponse){
config.isAjax = false;
var data = reponse.list;
var sum = reponse.list.length;
var result = '';
/* 剩餘不足一頁時只取剩下的 */
if (sum - offset < size) {
size = sum - offset;
}
/* 用 for 迴圈模擬 SQL 的 limit(offset, size) */
for (var i = offset; i < (offset + size); i++){
result += '<div class="weui_media_box weui_media_text">'
+ '<a href="' + data[i].url + '" target="_blank">'
+ '<h4 class="weui_media_title">' + data[i].title + '</h4></a>'
+ '<p class="weui_media_desc">' + data[i].desc + '</p>'
+ '</div>';
}
$('.js-blog-list').append(result);
/* 隱藏 more,並停止捲動加載請求 */
if ((offset + size) >= sum) {
$(".js-load-more").hide();
config.isEnd = true;
} else {
$(".js-load-more").show();
}
},
error: function(xhr, type){
alert('Ajax error!');
}
});
}
兩個設計細節值得記住:用 config.isAjax 做請求鎖,避免同一時間發出多個請求;用 config.isEnd 提早返回,讓捲動監聽在資料到底後立即停止工作。