本文參考官方文檔,總結 jQuery DataTables 的兩種數據加載方式:直接加載與延遲(服務端)加載。使用前需引入 jquery.js、jquery.dataTables.js,可選引入 dataTables.bootstrap.js。
直接加載是最簡單的方式,先把數據一次性取回,再交給 DataTables 渲染。頁面中用一個容器存放表格:
<div id="tid" class="col-sm-12 col-md-12"> <div id="secondtid" hidden="hidden"></div> </div>
由於項目使用了 Bootstrap 柵格,JS 部分通過 Ajax 取回 JSON 數據後初始化表格:
function getgaoxinqu() {
$('#secondtid').remove();
$("#tid").append("<div id='secondtid' style='width: 100%;'><table id='table_id' class='table table-striped table-bordered table-hover'></table></div>");
$.ajax({
url: '${contextPath}/mst/theme/otherOperatePlatformTheme.do?flag=gaoxinqu',
type: 'post',
success: function (data) {
var dataObj = eval(data);
$('#table_id').DataTable({
data: dataObj,
columns: [
{ data: 'id' },
{ data: 'name' },
{ data: 'dy' }
// ... 其餘列
],
order: [[0, "asc"]],
language: {
search: "在表格中搜索:",
sProcessing: "處理中...",
sLengthMenu: "顯示 _MENU_ 項結果",
sZeroRecords: "沒有匹配結果",
sInfo: "顯示第 _START_ 至 _END_ 項結果,共 _TOTAL_ 項",
oPaginate: { sFirst: "首頁", sPrevious: "上頁", sNext: "下頁", sLast: "末頁" }
}
});
},
error: function () { alert("異常!"); }
});
}
後端只需返回一個 JSON 數組即可,每個對象的屬性名與列定義中的 data 一一對應。
當數據量很大時,一次性加載全部數據會造成性能問題,此時應採用服務端分頁。由於老項目使用 Struts1,前台 form 接收參數有問題,於是直接用 servlet 接收請求出來。
function initDatatables() {
$('#listTable').DataTable({
"processing": true, // 處理中顯示
"serverSide": true, // 開啟服務端處理
"sScrollY": 300,
"columns": [
{ "data": "ID" },
{ "data": "YEAR" },
{ "data": "REGION" }
],
"ajax": {
"url": urlContextPath + "/mst/DatatablesLazyLoadServlet?flag=details",
"type": "POST",
"data": function (d) {
d['fieldCode'] = 'ID,YEAR,REGION';
d['tableCode'] = 'ODS10000030';
}
},
"oLanguage": {
"search": "在表格中搜索:",
"sProcessing": "處理中..."
}
});
}
後端 servlet 需要根據 DataTables 傳來的 draw、start、length 等參數進行分頁查詢,並返回符合 DataTables 協議的結構化數據,主要包括:
Map result = new LinkedHashMap();
result.put("draw", draw);
result.put("recordsTotal", totalCount); // 記錄總行數
result.put("recordsFiltered", filterCount); // 過濾後的行數
result.put("data", lt); // 當前頁數據
// 輸出為 JSON
其中 recordsTotal 為未過濾的總記錄數,recordsFiltered 為應用搜索條件後的記錄數,data 則是當前頁的具體數據。後端還需處理搜索過濾(getFilterSql)與排序(getOrderSql)等邏輯。
總體而言,直接加載適用於數據量小的場景,實現簡單;延遲加載則把分頁、排序、搜索都交由服務端處理,適合大數據量的表格。兩者各有適用場景,可根據實際需求選用。