DIV CSS 佈局教程網

dropload 上拉載入實戰:後端分頁 + 前端拼接的完整流程
編輯:關於JavaScript     

本文以一個「我找的券」列表為例,說明如何把 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 賦值。

整體來說,這類捲動載入的複雜度幾乎都集中在狀態管理上:請求出去了嗎、資料還有多少、外掛是否被鎖住。把這三個問題的答案在每個分支裡都交代清楚,功能自然就穩定了。

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