DataTables 是強大的表格插件,當資料量龐大時,把排序、搜尋、分頁交給後端處理會更有效率。以下說明幾個關鍵參數。
其值是一個 URL,DataTables 會送出 AJAX 請求向伺服器取資料。回傳的必須是嚴格符合 JSON 格式的字串,且以 aaData 作為資料的 key:
{
"aaData": [
{ "columnA": "valueA", "columnB": "valueB" }
]
}
設為 true 後,排序等操作會直接回到後台查詢再顯示,而非在前端進行。
用來取代預設的查詢函式,可自訂 AJAX 請求或對資料做前處理:
"fnServerData": function ( sUrl, aoData, fnCallback, oSettings ) {
oSettings.jqXHR = $.ajax({
"url": sUrl,
"data": aoData,
"success": function (json) {
if ( json.sError ) { oSettings.oApi._fnLog( oSettings, 0, json.sError ); }
$(oSettings.oInstance).trigger('xhr', [oSettings, json]);
fnCallback( json );
},
"dataType": "json",
"cache": false,
"type": oSettings.sServerMethod,
"error": function (xhr, error, thrown) {
if ( error == "parsererror" ) {
oSettings.oApi._fnLog( oSettings, 0, "DataTables warning: JSON data from server could not be parsed." );
}
}
});
}
例如後端若沒有用 aaData 當 key,就能在自己的回呼函式裡幫資料補上這個 key。
$('#example').dataTable({
"bProcessing": true,
"bServerSide": true,
"sAjaxSource": "scripts/server_processing.php",
"fnServerParams": function ( aoData ) {
aoData.push({ "name": "more_data", "value": "my_value" });
}
});
掌握這四個參數,就能讓 DataTables 與後端密切協作,處理大量資料時依然順暢。