XiaoSpring 2013-03-11
sAjaxSource参数,值是url。table会发送ajax请求,从服务器端获取数据。服务器端返回的数据应该是一个可以被转换成JSON对象的JSON字符串。这个字符串必须严格符合JSON格式的要求。否则会出错。该数据对象该对象的key应该是“aaData”,例如:
{ "aaData": { "columnA":"valueA", "columnB":"valueB", ... } }
bServerSide参数,设置成true,表示使用服务器端处理数据。当排序时,会直接到后台查询数据,直接显示,不会在前端进行排序操作。
fnServerData参数,用来自定义函数,代替DataTables插件默认的从服务器端查询数据的函数。默认的函数如下:
/** * @param {string} sSource HTTP source to obtain the data from (sAjaxSource) * @param {array} aoData A key/value pair object containing the data to send * to the server * @param {function} fnCallback to be called on completion of the data get * process that will draw the data on the page. * @param {object} oSettings DataTables settings object */ "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. This is caused by a JSON formatting error." ); } } }); },
我们可以用这个参数来自定义ajax请求,也可以对获取到的数据进行处理等操作。例如:
服务器端之返回表格的数据对象,没有用“aaData”作为数据的key,我们就可以在我们定义的回调函数里面,给数据加上“aaData” key。
fnServerParams参数,用来发送额外的数据给服务器。例如:
$('#example').dataTable( { "bProcessing": true, "bServerSide": true, "sAjaxSource": "scripts/server_processing.php", "fnServerParams": function ( aoData ) { aoData.push( { "name": "more_data", "value": "my_value" } ); } });