本文以一個「我找的券」列表為例,說明如何把 dropload 外掛接到真實的後端分頁介面上。重點不在外掛怎麼初始化,而在於前後端資料流如何對齊。

<script src="zepto.min.js"></script> <!-- jQuery 1.7+ 或 Zepto 二選一 --> <script src="dropload.min.js"></script>
兩者不可同時引入,否則外掛會被初始化兩次。
首屏由後端直接渲染(初始取 5 條),同時提供一個回傳 JSON 的介面供前端翻頁使用:
/** 首屏:我找的券 */
@Action("IFindTicket")
public String IFindTicket() {
try {
FuTransaction transaction = fuTransactionService.findByUserId(userId);
Map<String, Object> map = new HashMap<String, Object>();
map.put("transactionId", transaction == null ? 0L : transaction.getId());
List<FuStockAccount> accounts = fuStockAccountService.findAccountByMap(0, 5, map);
this.getActionContext().put("accounts", accounts);
} catch (Exception e) {
logger.error(e);
}
return SUCCESS;
}
/** 翻頁資料介面 */
@Action("findTicketData")
public String findTicketData() {
try {
FuTransaction transaction = fuTransactionService.findByUserId(userId);
Map<String, Object> map = new HashMap<String, Object>();
map.put("transactionId", transaction == null ? 0L : transaction.getId());
List<FuStockAccount> accounts =
fuStockAccountService.findAccountByMap(0, Integer.MAX_VALUE, map);
JSONArray array = new JSONArray();
for (FuStockAccount account : accounts) {
JSONObject obj = new JSONObject();
obj.put("id", account.getId());
obj.put("openEquity", account.getOpenEquity());
obj.put("capitalAccount", account.getCapitalAccount());
obj.put("transactionStatus", account.getTransactionStatus());
obj.put("status", account.getTransactionStatus() == 0 ? "正在操作" : "已退券");
obj.put("available", new DecimalFormat("#,###,##0.00")
.format(account.getAvailable() == null ? 0 : account.getAvailable()));
obj.put("ableMoney", new DecimalFormat("#,###,##0.00")
.format(account.getAbleMoney() == null ? 0 : account.getAbleMoney()));
obj.put("createTime",
new SimpleDateFormat("yyyy.MM.dd").format(account.getCreateTime()));
array.add(obj);
}
JSONObject json = new JSONObject();
json.put("array", array);
write(json.toString());
} catch (Exception e) {
logger.error(e);
}
return null;
}
這裡把格式化(千分位、日期、狀態文案)放在後端完成,前端拿到即可直接渲染,能減少一層轉換邏輯。
<div class="findTicList">
<table class="findTicIn" cellpadding="0" cellspacing="0" width="100%" border="0">
<c:forEach items="${accounts}" var="stock">
<tr>
<td class="smallSize firstTd">
<div class="upTh">
<span class="blueCol siz">${stock.openEquity}:${stock.capitalAccount}</span>
<c:if test="${stock.transactionStatus==0}"><a class="czIng">正在操作</a></c:if>
<c:if test="${stock.transactionStatus==1}"><a class="bacIng">已退券</a></c:if>
</div>
<div class="downLis">
<div class="leftDown">
<span class="leftDoFir">股票市值:<fmt:formatNumber
value="${empty stock.available ? 0 : stock.available}"
pattern="#,###,##0.00"/>元</span>
<span>可用資金:<fmt:formatNumber
value="${empty stock.ableMoney ? 0 : stock.ableMoney}"
pattern="#,###,##0.00"/>元</span>
</div>
<div class="rgtDown">
<a href="${ctx}/wxyqb/accountInfo.htm?id=${stock.id}">
<img class="lftJt" src="../images_yqb/mejtou.png"/>
</a>
</div>
</div>
<div class="ticketDat">發布時間:<fmt:formatDate
value="${stock.createTime}" pattern="yyyy.MM.dd"/></div>
</td>
</tr>
</c:forEach>
</table>
</div>
把行 HTML 的組裝抽成獨立函式,上拉與下拉共用,避免兩處重複維護:
<script src="${ctx}/js/dropload.min.js"></script>
<script>
$(function () {
var counter = 1; // 當前頁碼
var num = 5; // 每頁條數
var pageStart = 0, pageEnd = 0;
// 把單筆資料轉為表格列 HTML
function buildRow(item) {
var html = [];
html.push("<tr><td class='smallSize firstTd'>");
html.push("<div class='upTh'><span class='blueCol siz'>" +
item.openEquity + ":" + item.capitalAccount + "</span>");
html.push("<a class='" + (item.transactionStatus == 0 ? "czIng" : "bacIng") + "'>" +
item.status + "</a></div>");
html.push("<div class='downLis'><div class='leftDown'>");
html.push("<span class='leftDoFir'>股票市值:" + item.available + "元</span>");
html.push("<span>可用資金:" + item.ableMoney + "元</span></div>");
html.push("<div class='rgtDown'><a href='${ctx}/wxyqb/accountInfo.htm?id=" +
item.id + "'><img class='lftJt' src='../images_yqb/mejtou.png'/></a></div>");
html.push("<div class='ticketDat'>發布時間:" + item.createTime + "</div>");
html.push("</td></tr>");
return html.join('');
}
function fetchData(append) {
$.ajax({
type: 'POST',
url: '${ctx}/wxyqb/findTicketData.htm',
data: { userId: ${fuUser.id} },
dataType: 'json',
success: function (data) {
var list = data.array || [];
var html = list.map(buildRow).join('');
if (append) {
$('.findTicIn').append(html);
} else {
$('.findTicIn').html(html);
}
if (list.length < num) {
$('.dropload-down').hide(); // 已無更多資料
}
me.resetload(); // 無論如何都要重置
},
error: function () {
alert('Ajax error!');
me.resetload(); // 出錯同樣要重置,否則外掛會卡死
}
});
}
var me = $('.findTicList').dropload({
scrollArea: window,
domUp: {
domClass: 'dropload-up',
domRefresh: '<div class="dropload-refresh">↓下拉刷新</div>',
domUpdate: '<div class="dropload-update">↑釋放更新</div>',
domLoad: '<div class="dropload-load"><span class="loading"></span>加載中...</div>'
},
domDown: {
domClass: 'dropload-down',
domRefresh: '<div class="dropload-refresh">↑上拉加載更多</div>',
domLoad: '<div class="dropload-load"><span class="loading"></span>加載中...</div>',
domNoData: '<div class="dropload-noData">暫無更多評論</div>'
},
loadUpFn: function () {
fetchData(false); // 下拉刷新:整表替換
},
loadDownFn: function () {
counter++;
pageEnd = num * counter;
pageStart = pageEnd - num;
fetchData(true); // 上拉載入:向後追加
},
threshold: 50
});
});
</script>
1. resetload 是生命線。只要發了請求,成功、失敗、資料為空都必須呼叫,否則外掛的 loading 旗標會一直為 true,後續所有上拉都不再觸發。
2. 資料不足一頁時要主動收起提示。直接隱藏 .dropload-down,比讓使用者反覆上拉卻毫無反應要好。
3. 分頁參數與後端對齊。本示例後端一次回傳全部資料、由前端切片模擬分頁;真實場景中更應該把 offset / count 傳給後端做真正的分頁查詢,資料量大時差異非常明顯。
4. 拼接 HTML 要注意轉義。用字串拼接 innerHTML 時,若欄位內容來自使用者輸入,必須先做 HTML 轉義,否則會產生 XSS 風險。更安全的做法是建立 DOM 節點後用 textContent 賦值。
整體來說,這類捲動載入的複雜度幾乎都集中在狀態管理上:請求出去了嗎、資料還有多少、外掛是否被鎖住。把這三個問題的答案在每個分支裡都交代清楚,功能自然就穩定了。