189 8069 5689
官方网站：http://www.datatables.net/
简介：DataTables是一个jQuery的表格插件。这是一个高度灵活的工具，依据的基础逐步增强，这将增加先进的互动控制，支持任何HTML表格。
主要特点：
自动分页处理
即时表格数据过滤
数据排序以及数据类型自动检测
自动处理列宽度
可通过CSS定制样式
支持隐藏列
易用
可扩展性和灵活性
国际化
动态创建表格
免费的
参数初始化：
bAutoWidth
是否启用自动适应列宽
默认值：True
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bAutoWidth": false
});
});bDeferRender
是否启用延迟加载：当你使用AJAX数据源时，可以提升速度。
默认值：False
示例代码：
$(document).ready(function(){
var oTable = $('#example').dataTable({
"sAjaxSource":"sources/arrays.txt",
"bDeferRender":true
});
});bFilter
是否启用内置搜索功能：可以跨列搜索。
默认值：True
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bFilter":false
});
});bInfo
是否显示表格相关信息：例如翻页信息等。
默认值：True
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bInfo":false
});
});bJQueryUI
是否启用 jQuery UI 皮肤插件支持
默认值:False
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bJQueryUI":true
});
});bLengthChange
是否允许用户，在下拉列表自定义选择分页大小(10, 25, 50 and 100),需要分页支持
默认值：True
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bLengthChange": false
});
});bPaginate
是否开启分页
默认值：Ture
示例代码:
$(document).ready(function (){
$('#example').dataTable({
"bPaginate":false
});
});bProcessing
是否启用进度显示，进度条等等，对处理大量数据很有用处。
默认值：false
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bProcessing":true
});
});bScrollInfinite
是否开启内置滚动条，并且显示所有数据
默认值：fasle
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bScrollInfinite":true,
"bScrollCollapse":true,
"sScrollY": "200px"
});
});bServerSide
是否启用服务器处理数据源，必须sAjaxSource指明数据源位置
默认值：False
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bServerSide":true,
"sAjaxSource":"xhr.php"
});
});bSort
是否开启列排序功能，如果想禁用某一列排序，可以在每列设置使用bSortable参数
默认值：True
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bSort":false
});
});bSortClasses
开关，指定当当前列在排序时，是否增加classes ‘sorting_1′, ‘sorting_2′ and ‘sorting_3’，打开后，在处理大数据时，性能有所损失
默认值：False
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bSortClasses":false
});
});bStateSave
是否开启cookies保存当前状态信息
默认值：false
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"bStateSave": true
});
});sScrollX
是否开启水平滚动条
默认值：空 （字符串类型）
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"sScrollX":"100%",
"bScrollCollapse": true
});
});sScrollY
是否开启垂直滚动条，滚动条大小受限于Datatable的高度大小
默认值：空（字符串类型）
示例代码：
$(document).ready(function(){
$('#example').dataTable({
"sScrollY":"200px",
"bPaginate":false
});
});| 属性名称 | 取值范围 | 解释 |
| bAutoWidth | true or false, default true | 是否自动计算表格各列宽度 |
| bDeferRender | true or false, default false | 用于渲染的一个参数 |
| bFilter | true or false, default true | 开关，是否启用客户端过滤功能 |
| bInfo | true or false, default true | 开关，是否显示表格的一些信息 |
| bJQueryUI | true or false, default false | 是否使用jquery ui themeroller的风格 |
| bLengthChange | true or false, default true | 开关，是否显示一个每页长度的选择条（需要分页器支持） |
| bPaginate | true or false, default true | 开关，是否显示（使用）分页器 |
| bProcessing | true or false, defualt false | 开关，以指定当正在处理数据的时候，是否显示“正在处理”这个提示信息 |
| bScrollInfinite | true or false, default false | 开关，以指定是否无限滚动（与sScrollY配合使用），在大数据量的时候很有用。当这个标志为true的时候，分页器就默认关闭 |
| bSort | true or false, default true | 开关，是否让各列具有按列排序功能 |
| bSortClasses | true or false, default true | 开关，指定当当前列在排序时，是否增加classes ‘sorting_1′, ‘sorting_2′ and ‘sorting_3’，打开后，在处理大数据时，性能有所损失 |
| bStateSave | true or false, default false | 开关，是否打开客户端状态记录功能。这个数据是记录在cookies中的，打开了这个记录后，即使刷新一次页面，或重新打开浏览器，之前的状态都是保存下来的 |
| sScrollX | ‘disabled’ or ‘100%’ 类似的字符串 | 是否开启水平滚动，以及指定滚动区域大小 |
| sScrollY | ‘disabled’ or ‘200px’ 类似的字符串 | 是否开启垂直滚动，以及指定滚动区域大小 |
| – | – | – |
| 选项 | ||
| aaSorting | array array[int,string], 如[], [[0,’asc’], [0,’desc’]] | 指定按多列数据排序的依据 |
| aaSortingFixed | 同上 | 同上。唯一不同点是不能被用户的自定义配置冲突 |
| aLengthMenu | default [10, 25, 50, 100]，可以为一维数组，也可为二维数组，比如：[[10, 25, 50, -1], [10, 25, 50, “All”]] | 这个为选择每页的条目数，当使用一个二维数组时，二维层面只能有两个元素，第一个为显示每页条目数的选项，第二个是关于这些选项的解释 |
| aoSearchCols | default null, 类似：[null, {“sSearch”: “My filter”}, null,{“sSearch”: “^[0-9]”, “bEscapeRegex”: false}] | 给每个列单独定义其初始化搜索列表特性（这一块还没搞懂） |
| asStripClasses | default [‘odd’, ‘even’], 比如[‘strip1′, ‘strip2′, ‘strip3′] | 指定要被应用到各行的class风格，会自动循环 |
| bDestroy | true or false, default false | 用于当要在同一个元素上执行新的dataTable绑定时，将之前的那个数据对象清除掉，换以新的对象设置 |
| bRetrieve | true or false, default false | 用于指明当执行dataTable绑定时，是否返回DataTable对象 |
| bScrollCollapse | true or false, default false | 指定适当的时候缩起滚动视图 |
| bSortCellsTop | true or false, default false | （未知的东东） |
| iCookieDuration | 整数，默认7200，单位为秒 | 指定用于存储客户端信息到cookie中的时间长度，超过这个时间后，自动过期 |
| iDeferLoading | 整数，默认为null | 延迟加载，它的参数为要加载条目的数目，通常与bServerSide，sAjaxSource等配合使用 |
| iDisplayLength | 整数，默认为10 | 用于指定一屏显示的条数，需开启分页器 |
| iDisplayStart | 整数，默认为0 | 用于指定从哪一条数据开始显示到表格中去 |
| iScrollLoadGap | 整数，默认为100 | 用于指定当DataTable设置为滚动时，最多可以一屏显示多少条数据 |
| oSearch | 默认{ “sSearch”: “”, “bRegex”: false, “bSmart”: true } | 又是初始时指定搜索参数相关的，有点复杂，没搞懂目前 |
| sAjaxDataProp | 字符串，default ‘aaData’ | 指定当从服务端获取表格数据时，数据项使用的名字 |
| sAjaxSource | URL字符串，default null | 指定要从哪个URL获取数据 |
| sCookiePrefix | 字符串，default ‘SpryMedia_DataTables_’ | 当打开状态存储特性后，用于指定存储在cookies中的字符串的前缀名字 |
| sDom | default lfrtip (when bJQueryUI is false) or <“H”lfr>t<“F”ip> (when bJQueryUI is true) | 这是用于定义DataTable布局的一个强大的属性，另开专门文档来补充说明吧 |
| sPaginationType | ‘full_numbers’ or ‘two_button’, default ‘two_button’ | 用于指定分页器风格 |
| sScrollXInner | string default ‘disabled’ | 又是水平滚动相关的，没搞懂啥意思 |
| 回调函数名称 | 参数 | 返回值 | 默认 | 功能 |
| fnCookieCallback | 1.string: Name of the cookie defined by DataTables
2.object: Data to be stored in the cookie 3.string: Cookie expires string 4.string: Path of the cookie to set | string: cookie formatted string (which should be encoded by using encodeURIComponent()) | null | 当每次cookies改变时，会触发这个函数调用 |
| fnDrawCallback | 无 | 无 | 无 | 在每次table被draw完后调用，至于做什么就看着办吧 |
| fnFooterCallback | 1.node : “TR” element for the footer
2.array array strings : Full table data (as derived from the original HTML) 3.int : Index for the current display starting point in the display array 4.int : Index for the current display ending point in the display array 5.array int : Index array to translate the visual position to the full data array | 无 | 无 | 用于在每次重画的时候修改表格的脚部 |
| fnFormatNumber | 1.int : number to be formatted | String : formatted string for DataTables to show the number | 有默认的 | 用于在大数字上，自动加入一些逗号，分隔开 |
| fnHeaderCallback | 1.node : “TR” element for the header
2.array array strings : Full table data (as derived from the original HTML) 3.int : Index for the current display starting point in the display array 4.int : Index for the current display ending point in the display array 5.array int : Index array to translate the visual position to the full data array | 无 | 无 | 用于在每次draw发生时，修改table的header |
| fnInfoCallback | 1.object: DataTables settings object
2.int: Starting position in data for the draw 3.int: End position in data for the draw 4.int: Total number of rows in the table (regardless of filtering) 5.int: Total number of rows in the data set, after filtering 6.string: The string that DataTables has formatted using it’s own rules | string: The string to be displayed in the information element. | 无 | 用于传达table信息 |
| fnInitComplete | 1.object:oSettings – DataTables settings object | 无 | 无 | 表格初始化完成后调用 |
| fnPreDrawCallback | 1.object:oSettings – DataTables settings object | Boolean | 无 | 用于在开始绘制之前调用，返回false的话，会阻止draw事件发生；返回其它值，draw可以顺利执行 |
| fnRowCallback | 1.node : “TR” element for the current row
2.array strings : Raw data array for this row (as derived from the original HTML) 3.int : The display index for the current table draw 4.int : The index of the data in the full list of rows (after filtering) | node : “TR” element for the current row | 无 | 当创建了行，但还未绘制到屏幕上的时候调用，通常用于改变行的class风格 |
| fnServerData | 1.string: HTTP source to obtain the data from (i.e. sAjaxSource)
2.array objects: A key/value pair object containing the data to send to the server 3.function: Function to be called on completion of the data get process that will draw the data on the page. | void | $.getJSON | 用于替换默认发到服务端的请求操作 |
| fnStateLoadCallback | 1.object:oSettings – DataTables settings object
2.object:oData – Object containing information retrieved from the state saving cookie which should be restored. For the exact properties please refer to the DataTables code. | Boolean – false if the state should not be loaded, true otherwise | 无 | 在cookies中的数据被加载前执行，可以方便地修改这些数据 |
| fnStateSaveCallback | 1.object:oSettings – DataTables settings object
2.String:sValue – a JSON string (without the final closing brace) which should be stored in the state saving cookie. | String – the full string that should be used to save the state | 无 | 在状态数据被存储到cookies前执行，可以方便地做一些预操作 |
具体的参数意思可以参考官方文档。这里提一下fnServerParams。这个参数可以帮我们传递页面的其他参数，这个例子中，我传递了关键字、起止日期信息，主要用于服务端的数据查找过滤。
用chrome看一下控件会向服务端传递什么：
这是底部的分页栏
当我点第二页时，传递参数如下：
注意到iDisplayLength是10，因为我默认是每页展示10条数据，这个值可以调整。当我点第二页时，iDisplayStart从0变到10。其实分页就是这么回事，前端告诉服务端，我需要那段数据，你给我找出来返回给我。
服务端的返回格式如下（PHP）：
$ret = array( "sEcho" => intval($_GET['sEcho']), "iTotalRecords" => $data_count, "iTotalDisplayRecords" => $data_count, "aaData" => array() );
另外有需要云服务器可以了解下创新互联scvps.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。