jQuery 的插件 dataTables
2015-09-09 18:07
656 查看
---恢复内容开始---
jQuery的插件dataTables是一个优秀的表格插件,提供了针对表格的排序、浏览器分页、服务器分页、筛选、格式化等功能。dataTables的网站上也提供了大量的演示和详细的文档进行说明,为了方便学习使用,这里一步一步进行说明。
首先,需要到dataTables的网站http://www.datatables.net/下载这个脚本库,
然后,在网页中先加入jQuery的引用,然后,加入dataTables的引用。
引入CSS文件和JS文件
--------------------------------------------------------------------------
<styletype="text/css"title="currentStyle">
@import"DataTables-1.8.1/media/css/demo_page.css";
@import"DataTables-1.8.1/media/css/demo_table.css";
@import"DataTables-1.8.1/media/css/demo_table_jui.css";
</style>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.js"></script>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.dataTables.js"></script>
--------------------------------------------------------------------------
-----------最简单的方式:
$(document).ready(function(){
$("#example").dataTable();
});
----------也可以自己定义各属性:
<scripttype="text/javascript"language="javascript">
$(document).ready(function(){
$("#example").dataTable({
//"bPaginate":true,//开关,是否显示分页器
//"bInfo":true,//开关,是否显示表格的一些信息
//"bFilter":true,//开关,是否启用客户端过滤器
//"sDom":"<>lfrtip<>",
//"bAutoWith":false,
//"bDeferRender":false,
//"bJQueryUI":false,//开关,是否启用JQueryUI风格
//"bLengthChange":true,//开关,是否显示每页大小的下拉框
//"bProcessing":true,
//"bScrollInfinite":false,
//"sScrollY":"800px",//是否开启垂直滚动,以及指定滚动区域大小,可设值:'disabled','2000px'
//"bSort":true,//开关,是否启用各列具有按列排序的功能
//"bSortClasses":true,
//"bStateSave":false,//开关,是否打开客户端状态记录功能。这个数据是记录在cookies中的,
打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的-
------当值为true时aoColumnDefs不能隐藏列
//"sScrollX":"50%",//是否开启水平滚动,以及指定滚动区域大小,可设值:'disabled','2000%'
//"aaSorting":[[0,"asc"]],
//"aoColumnDefs":[{"bVisible":false,"aTargets":[0]}]//隐藏列
//"sDom":'<"H"if>t<"F"if>',
"bAutoWidth":false,//自适应宽度
"aaSorting":[[1,"asc"]],
"sPaginationType":"full_numbers",
"oLanguage":{
"sProcessing":"正在加载中......",
"sLengthMenu":"每页显示_MENU_条记录",
"sZeroRecords":"对不起,查询不到相关数据!",
"sEmptyTable":"表中无数据存在!",
"sInfo":"当前显示_START_到_END_条,共_TOTAL_条记录",
"sInfoFiltered":"数据表中共为_MAX_条记录",
"sSearch":"搜索",
"oPaginate":{
"sFirst":"首页",
"sPrevious":"上一页",
"sNext":"下一页",
"sLast":"末页"
}
}//多语言配置
});
});
</script>
----------------页面:
对于dataTables来说,表格必须通过thead和tbody进行说明,如下所示,
如果没有thead将会报错。
最为简单的使用方式,就是零配置的方式。
以下是在进行dataTable绑定处理时候可以附加的参数:
DataTable支持如下回调函数
表格的效果
注意,红框表示了四个默认的设置效果,分别用来选择每页的行数,表格的过滤器,表格的信息和换页。
此时,使用了几个默认的参数设置。在dataTables中,参数名称的前缀用来说明参数的数据类型,很明显,b表示布尔类型,i表示整数类型,s表示字符串类型。
bPaginate:是否分页,默认为true,分页
iDisplayLength:每页的行数,每页默认数量:10
sPaginationType:分页样式,支持两种内置方式,two_button和full_numbers,默认使用two_button。
bLengthChange:是否允许用户通过一个下拉列表来选择分页后每页的行数。行数为10,25,50,100。这个设置需要bPaginate支持。默认为true。
bFilter:启用或禁止数据过滤,默认为true。注意,如果使用过滤功能,但是希望关闭默认的过滤输入框,应使用sDom
bInfo:允许或者禁止表信息的显示,默认为true,显示信息。
我们也可以通过传递一个初始化参数对象来改变这些设置。例如,下面的例子将每页的行数设置为20行。
原文转载:http://blog.csdn.net/cdefg198/article/details/7182341
---恢复内容结束---
jQuery的插件dataTables是一个优秀的表格插件,提供了针对表格的排序、浏览器分页、服务器分页、筛选、格式化等功能。dataTables的网站上也提供了大量的演示和详细的文档进行说明,为了方便学习使用,这里一步一步进行说明。
首先,需要到dataTables的网站http://www.datatables.net/下载这个脚本库,
然后,在网页中先加入jQuery的引用,然后,加入dataTables的引用。
引入CSS文件和JS文件
--------------------------------------------------------------------------
<styletype="text/css"title="currentStyle">
@import"DataTables-1.8.1/media/css/demo_page.css";
@import"DataTables-1.8.1/media/css/demo_table.css";
@import"DataTables-1.8.1/media/css/demo_table_jui.css";
</style>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.js"></script>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.dataTables.js"></script>
--------------------------------------------------------------------------
-----------最简单的方式:
$(document).ready(function(){
$("#example").dataTable();
});
----------也可以自己定义各属性:
<scripttype="text/javascript"language="javascript">
$(document).ready(function(){
$("#example").dataTable({
//"bPaginate":true,//开关,是否显示分页器
//"bInfo":true,//开关,是否显示表格的一些信息
//"bFilter":true,//开关,是否启用客户端过滤器
//"sDom":"<>lfrtip<>",
//"bAutoWith":false,
//"bDeferRender":false,
//"bJQueryUI":false,//开关,是否启用JQueryUI风格
//"bLengthChange":true,//开关,是否显示每页大小的下拉框
//"bProcessing":true,
//"bScrollInfinite":false,
//"sScrollY":"800px",//是否开启垂直滚动,以及指定滚动区域大小,可设值:'disabled','2000px'
//"bSort":true,//开关,是否启用各列具有按列排序的功能
//"bSortClasses":true,
//"bStateSave":false,//开关,是否打开客户端状态记录功能。这个数据是记录在cookies中的,
打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的-
------当值为true时aoColumnDefs不能隐藏列
//"sScrollX":"50%",//是否开启水平滚动,以及指定滚动区域大小,可设值:'disabled','2000%'
//"aaSorting":[[0,"asc"]],
//"aoColumnDefs":[{"bVisible":false,"aTargets":[0]}]//隐藏列
//"sDom":'<"H"if>t<"F"if>',
"bAutoWidth":false,//自适应宽度
"aaSorting":[[1,"asc"]],
"sPaginationType":"full_numbers",
"oLanguage":{
"sProcessing":"正在加载中......",
"sLengthMenu":"每页显示_MENU_条记录",
"sZeroRecords":"对不起,查询不到相关数据!",
"sEmptyTable":"表中无数据存在!",
"sInfo":"当前显示_START_到_END_条,共_TOTAL_条记录",
"sInfoFiltered":"数据表中共为_MAX_条记录",
"sSearch":"搜索",
"oPaginate":{
"sFirst":"首页",
"sPrevious":"上一页",
"sNext":"下一页",
"sLast":"末页"
}
}//多语言配置
});
});
</script>
----------------页面:
对于dataTables来说,表格必须通过thead和tbody进行说明,如下所示,
如果没有thead将会报错。
最为简单的使用方式,就是零配置的方式。
以下是在进行dataTable绑定处理时候可以附加的参数:
DataTable支持如下回调函数
表格的效果
注意,红框表示了四个默认的设置效果,分别用来选择每页的行数,表格的过滤器,表格的信息和换页。
此时,使用了几个默认的参数设置。在dataTables中,参数名称的前缀用来说明参数的数据类型,很明显,b表示布尔类型,i表示整数类型,s表示字符串类型。
bPaginate:是否分页,默认为true,分页
iDisplayLength:每页的行数,每页默认数量:10
sPaginationType:分页样式,支持两种内置方式,two_button和full_numbers,默认使用two_button。
bLengthChange:是否允许用户通过一个下拉列表来选择分页后每页的行数。行数为10,25,50,100。这个设置需要bPaginate支持。默认为true。
bFilter:启用或禁止数据过滤,默认为true。注意,如果使用过滤功能,但是希望关闭默认的过滤输入框,应使用sDom
bInfo:允许或者禁止表信息的显示,默认为true,显示信息。
我们也可以通过传递一个初始化参数对象来改变这些设置。例如,下面的例子将每页的行数设置为20行。
原文转载:http://blog.csdn.net/cdefg198/article/details/7182341
jQuery的插件dataTables是一个优秀的表格插件,提供了针对表格的排序、浏览器分页、服务器分页、筛选、格式化等功能。dataTables的网站上也提供了大量的演示和详细的文档进行说明,为了方便学习使用,这里一步一步进行说明。
首先,需要到dataTables的网站
然后,在网页中先加入jQuery的引用,然后,加入dataTables的引用。
引入CSS文件和JS文件
--------------------------------------------------------------------------
<styletype="text/css"title="currentStyle">
@import"DataTables-1.8.1/media/css/demo_page.css";
@import"DataTables-1.8.1/media/css/demo_table.css";
@import"DataTables-1.8.1/media/css/demo_table_jui.css";
</style>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.js"></script>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.dataTables.js"></script>
--------------------------------------------------------------------------
-----------最简单的方式:
$(document).ready(function(){
$("#example").dataTable();
});
----------也可以自己定义各属性:
<scripttype="text/javascript"language="javascript">
$(document).ready(function(){
$("#example").dataTable({
//"bPaginate":true,//开关,是否显示分页器
//"bInfo":true,//开关,是否显示表格的一些信息
//"bFilter":true,//开关,是否启用客户端过滤器
//"sDom":"<>lfrtip<>",
//"bAutoWith":false,
//"bDeferRender":false,
//"bJQueryUI":false,//开关,是否启用JQueryUI风格
//"bLengthChange":true,//开关,是否显示每页大小的下拉框
//"bProcessing":true,
//"bScrollInfinite":false,
//"sScrollY":"800px",//是否开启垂直滚动,以及指定滚动区域大小,可设值:'disabled','2000px'
//"bSort":true,//开关,是否启用各列具有按列排序的功能
//"bSortClasses":true,
//"bStateSave":false,//开关,是否打开客户端状态记录功能。这个数据是记录在cookies中的,
打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的-
------当值为true时aoColumnDefs不能隐藏列
//"sScrollX":"50%",//是否开启水平滚动,以及指定滚动区域大小,可设值:'disabled','2000%'
//"aaSorting":[[0,"asc"]],
//"aoColumnDefs":[{"bVisible":false,"aTargets":[0]}]//隐藏列
//"sDom":'<"H"if>t<"F"if>',
"bAutoWidth":false,//自适应宽度
"aaSorting":[[1,"asc"]],
"sPaginationType":"full_numbers",
"oLanguage":{
"sProcessing":"正在加载中......",
"sLengthMenu":"每页显示_MENU_条记录",
"sZeroRecords":"对不起,查询不到相关数据!",
"sEmptyTable":"表中无数据存在!",
"sInfo":"当前显示_START_到_END_条,共_TOTAL_条记录",
"sInfoFiltered":"数据表中共为_MAX_条记录",
"sSearch":"搜索",
"oPaginate":{
"sFirst":"首页",
"sPrevious":"上一页",
"sNext":"下一页",
"sLast":"末页"
}
}//多语言配置
});
});
</script>
----------------页面:
对于dataTables来说,表格必须通过thead和tbody进行说明,如下所示,
< table cellpadding = "0" cellspacing = "0" border = "0" class = "display" id = "example" > |
< thead > |
< tr > |
< th > |
Rendering engine |
</ th > |
< th > |
Browser |
</ th > |
< th > |
Platform(s) |
</ th > |
< th > |
Engine version |
</ th > |
< th > |
CSS grade |
</ th > |
</ tr > |
</ thead > |
< tbody > |
< tr class = "odd gradeX" > |
< td > |
Trident |
</ td > |
< td > |
Internet Explorer4.0 |
</ td > |
< td > |
Win 95+ |
</ td > |
< td class = "center" > |
4 |
</ td > |
< td class = "center" > |
X |
</ td > |
</ tr > |
最为简单的使用方式,就是零配置的方式。
/* |
* |
*/ |
$(document).ready( function (){ |
$( '#example' ).dataTable(); |
});
以下是在进行dataTable绑定处理时候可以附加的参数:
属性名称 | 取值范围 | 解释 |
bAutoWidth | trueorfalse,defaulttrue | 是否自动计算表格各列宽度 |
bDeferRender | trueorfalse,defaultfalse | 用于渲染的一个参数 |
bFilter | trueorfalse,defaulttrue | 开关,是否启用客户端过滤功能 |
bInfo | trueorfalse,defaulttrue | 开关,是否显示表格的一些信息 |
bJQueryUI | trueorfalse,defaultfalse | 是否使用jqueryuithemeroller的风格 |
bLengthChange | trueorfalse,defaulttrue | 开关,是否显示一个每页长度的选择条(需要分页器支持) |
bPaginate | trueorfalse,defaulttrue | 开关,是否显示(使用)分页器 |
bProcessing | trueorfalse,defualtfalse | 开关,以指定当正在处理数据的时候,是否显示“正在处理”这个提示信息 |
bScrollInfinite | trueorfalse,defaultfalse | 开关,以指定是否无限滚动(与sScrollY配合使用),在大数据量的时候很有用。当这个标志为true的时候,分页器就默认关闭 |
bSort | trueorfalse,defaulttrue | 开关,是否让各列具有按列排序功能 |
bSortClasses | trueorfalse,defaulttrue | 开关,指定当当前列在排序时,是否增加classes'sorting_1','sorting_2'and'sorting_3',打开后,在处理大数据时,性能有所损失 |
bStateSave | trueorfalse,defaultfalse | 开关,是否打开客户端状态记录功能。这个数据是记录在cookies中的,打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的 |
sScrollX | 'disabled'or'100%'类似的字符串 | 是否开启水平滚动,以及指定滚动区域大小 |
sScrollY | 'disabled'or'200px'类似的字符串 | 是否开启垂直滚动,以及指定滚动区域大小 |
-- | -- | -- |
选项 | ||
aaSorting | arrayarray[int,string],如[],[[0,'asc'],[0,'desc']] | 指定按多列数据排序的依据 |
aaSortingFixed | 同上 | 同上。唯一不同点是不能被用户的自定义配置冲突 |
aLengthMenu | default[10,25,50,100],可以为一维数组,也可为二维数组,比如:[[10,25,50,-1],[10,25,50,"All"]] | 这个为选择每页的条目数,当使用一个二维数组时,二维层面只能有两个元素,第一个为显示每页条目数的选项,第二个是关于这些选项的解释 |
aoSearchCols | defaultnull,类似:[null,{"sSearch":"Myfilter"},null,{"sSearch":"^[0-9]","bEscapeRegex":false}] | 给每个列单独定义其初始化搜索列表特性(这一块还没搞懂) |
asStripClasses | default['odd','even'],比如['strip1','strip2','strip3'] | 指定要被应用到各行的class风格,会自动循环 |
bDestroy | trueorfalse,defaultfalse | 用于当要在同一个元素上执行新的dataTable绑定时,将之前的那个数据对象清除掉,换以新的对象设置 |
bRetrieve | trueorfalse,defaultfalse | 用于指明当执行dataTable绑定时,是否返回DataTable对象 |
bScrollCollapse | trueorfalse,defaultfalse | 指定适当的时候缩起滚动视图 |
bSortCellsTop | trueorfalse,defaultfalse | (未知的东东) |
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字符串,defaultnull | 指定要从哪个URL获取数据 |
sCookiePrefix | 字符串,default'SpryMedia_DataTables_' | 当打开状态存储特性后,用于指定存储在cookies中的字符串的前缀名字 |
sDom | defaultlfrtip(whenbJQueryUIisfalse)or<"H"lfr>t<"F"ip>(whenbJQueryUIistrue) | 这是用于定义DataTable布局的一个强大的属性,另开专门文档来补充说明吧 |
sPaginationType | 'full_numbers'or'two_button',default'two_button' | 用于指定分页器风格 |
sScrollXInner | stringdefault'disabled' | 又是水平滚动相关的,没搞懂啥意思 |
回调函数名称 | 参数 | 返回值 | 默认 | 功能 |
fnCookieCallback | 1.string: NameofthecookiedefinedbyDataTables2.object:Datatobestoredin thecookie3.string:Cookieexpiresstring4.string:Pathofthecookie toset | string:cookieformattedstring(whichshouldbeencodedbyusingencodeURIComponent()) | null | 当每次cookies改变时,会触发这个函数调用 |
fnDrawCallback | 无 | 无 | 无 | 在每次table被draw完后调用,至于做什么就看着办吧 |
fnFooterCallback | 1.node: "TR"elementforthefooter2.arrayarraystrings:Fulltabledata(as derivedfromtheoriginalHTML)3.int:Indexforthecurrentdisplay startingpointinthedisplayarray<4.int :Indexforthecurrentdisplayendingpointinthedisplayarray 5.arrayint:Indexarraytotranslatethevisualpositiontothefull dataarray | 无 | 无 | 用于在每次重画的时候修改表格的脚部 |
fnFormatNumber | 1.int:numbertobeformatted | String:formattedstringforDataTablestoshowthenumber | 有默认的 | 用于在大数字上,自动加入一些逗号,分隔开 |
fnHeaderCallback | 1.node: "TR"elementfortheheader2.arrayarraystrings:Fulltabledata(as derivedfromtheoriginalHTML)3.int:Indexforthecurrentdisplay startingpointinthedisplayarray4.int :Indexforthecurrentdisplayendingpointinthedisplayarray 5.arrayint:Indexarraytotranslatethevisualpositiontothefull dataarray | 无 | 无 | 用于在每次draw发生时,修改table的header |
fnInfoCallback | 1.object: DataTablessettingsobject2.int:Startingpositionindataforthe draw3.int:Endpositionindataforthedraw4.int:Totalnumberof rowsinthetable(regardlessoffiltering)5.int: Totalnumberofrowsinthedataset,afterfiltering6.string:The stringthatDataTableshasformattedusingit'sownrules | string:Thestringtobedisplayedintheinformationelement. | 无 | 用于传达table信息 |
fnInitComplete | 1.object:oSettings-DataTablessettingsobject | 无 | 无 | 表格初始化完成后调用 |
fnPreDrawCallback | 1.object:oSettings-DataTablessettingsobject | Boolean | 无 | 用于在开始绘制之前调用,返回false的话,会阻止draw事件发生;返回其它值,draw可以顺利执行 |
fnRowCallback | 1.node: "TR"elementforthecurrentrow2.arraystrings:Rawdataarrayfor thisrow(asderivedfromtheoriginalHTML)3.int:Thedisplayindex forthecurrenttabledraw4.int:Theindex ofthedatainthefulllistofrows(afterfiltering) | node:"TR"elementforthecurrentrow | 无 | 当创建了行,但还未绘制到屏幕上的时候调用,通常用于改变行的class风格 |
fnServerData | 1.string: HTTPsourcetoobtainthedatafrom(i.e.sAjaxSource)2.arrayobjects: Akey/valuepairobjectcontainingthedatatosendtotheserver 3.function:Functiontobecalledoncompletion ofthedatagetprocessthatwilldrawthedataonthepage. | void | $.getJSON | 用于替换默认发到服务端的请求操作 |
fnStateLoadCallback | 1.object:oSettings -DataTablessettingsobject2.object:oData-Objectcontaining informationretrievedfromthestatesavingcookiewhichshouldbe restored.Fortheexactpropertiesplease refertotheDataTablescode. | Boolean-falseifthestateshouldnotbeloaded,trueotherwise | 无 | 在cookies中的数据被加载前执行,可以方便地修改这些数据 |
fnStateSaveCallback | 1.object:oSettings -DataTablessettingsobject2.String:sValue-aJSONstring(without thefinalclosingbrace)whichshouldbestoredinthestatesaving cookie. | String-thefullstringthatshouldbeusedtosavethestate | 无 | 在状态数据被存储到cookies前执行,可以方便地做一些预操作 |
注意,红框表示了四个默认的设置效果,分别用来选择每页的行数,表格的过滤器,表格的信息和换页。
此时,使用了几个默认的参数设置。在dataTables中,参数名称的前缀用来说明参数的数据类型,很明显,b表示布尔类型,i表示整数类型,s表示字符串类型。
bPaginate:是否分页,默认为true,分页
iDisplayLength:每页的行数,每页默认数量:10
sPaginationType:分页样式,支持两种内置方式,two_button和full_numbers,默认使用two_button。
bLengthChange:是否允许用户通过一个下拉列表来选择分页后每页的行数。行数为10,25,50,100。这个设置需要bPaginate支持。默认为true。
bFilter:启用或禁止数据过滤,默认为true。注意,如果使用过滤功能,但是希望关闭默认的过滤输入框,应使用sDom
bInfo:允许或者禁止表信息的显示,默认为true,显示信息。
我们也可以通过传递一个初始化参数对象来改变这些设置。例如,下面的例子将每页的行数设置为20行。
$( function () { |
$( "#example" ).dataTable( |
{ |
iDisplayLength: 20 |
} |
); |
});
原文转载:http://blog.csdn.net/cdefg198/article/details/7182341
---恢复内容结束---
jQuery的插件dataTables是一个优秀的表格插件,提供了针对表格的排序、浏览器分页、服务器分页、筛选、格式化等功能。dataTables的网站上也提供了大量的演示和详细的文档进行说明,为了方便学习使用,这里一步一步进行说明。
首先,需要到dataTables的网站
然后,在网页中先加入jQuery的引用,然后,加入dataTables的引用。
引入CSS文件和JS文件
--------------------------------------------------------------------------
<styletype="text/css"title="currentStyle">
@import"DataTables-1.8.1/media/css/demo_page.css";
@import"DataTables-1.8.1/media/css/demo_table.css";
@import"DataTables-1.8.1/media/css/demo_table_jui.css";
</style>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.js"></script>
<scripttype="text/javascript"language="javascript"src="DataTables-1.8.1/media/js/jquery.dataTables.js"></script>
--------------------------------------------------------------------------
-----------最简单的方式:
$(document).ready(function(){
$("#example").dataTable();
});
----------也可以自己定义各属性:
<scripttype="text/javascript"language="javascript">
$(document).ready(function(){
$("#example").dataTable({
//"bPaginate":true,//开关,是否显示分页器
//"bInfo":true,//开关,是否显示表格的一些信息
//"bFilter":true,//开关,是否启用客户端过滤器
//"sDom":"<>lfrtip<>",
//"bAutoWith":false,
//"bDeferRender":false,
//"bJQueryUI":false,//开关,是否启用JQueryUI风格
//"bLengthChange":true,//开关,是否显示每页大小的下拉框
//"bProcessing":true,
//"bScrollInfinite":false,
//"sScrollY":"800px",//是否开启垂直滚动,以及指定滚动区域大小,可设值:'disabled','2000px'
//"bSort":true,//开关,是否启用各列具有按列排序的功能
//"bSortClasses":true,
//"bStateSave":false,//开关,是否打开客户端状态记录功能。这个数据是记录在cookies中的,
打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的-
------当值为true时aoColumnDefs不能隐藏列
//"sScrollX":"50%",//是否开启水平滚动,以及指定滚动区域大小,可设值:'disabled','2000%'
//"aaSorting":[[0,"asc"]],
//"aoColumnDefs":[{"bVisible":false,"aTargets":[0]}]//隐藏列
//"sDom":'<"H"if>t<"F"if>',
"bAutoWidth":false,//自适应宽度
"aaSorting":[[1,"asc"]],
"sPaginationType":"full_numbers",
"oLanguage":{
"sProcessing":"正在加载中......",
"sLengthMenu":"每页显示_MENU_条记录",
"sZeroRecords":"对不起,查询不到相关数据!",
"sEmptyTable":"表中无数据存在!",
"sInfo":"当前显示_START_到_END_条,共_TOTAL_条记录",
"sInfoFiltered":"数据表中共为_MAX_条记录",
"sSearch":"搜索",
"oPaginate":{
"sFirst":"首页",
"sPrevious":"上一页",
"sNext":"下一页",
"sLast":"末页"
}
}//多语言配置
});
});
</script>
----------------页面:
对于dataTables来说,表格必须通过thead和tbody进行说明,如下所示,
< table cellpadding = "0" cellspacing = "0" border = "0" class = "display" id = "example" > |
< thead > |
< tr > |
< th > |
Rendering engine |
</ th > |
< th > |
Browser |
</ th > |
< th > |
Platform(s) |
</ th > |
< th > |
Engine version |
</ th > |
< th > |
CSS grade |
</ th > |
</ tr > |
</ thead > |
< tbody > |
< tr class = "odd gradeX" > |
< td > |
Trident |
</ td > |
< td > |
Internet Explorer4.0 |
</ td > |
< td > |
Win 95+ |
</ td > |
< td class = "center" > |
4 |
</ td > |
< td class = "center" > |
X |
</ td > |
</ tr > |
最为简单的使用方式,就是零配置的方式。
/* |
* |
*/ |
$(document).ready( function (){ |
$( '#example' ).dataTable(); |
});
以下是在进行dataTable绑定处理时候可以附加的参数:
属性名称 | 取值范围 | 解释 |
bAutoWidth | trueorfalse,defaulttrue | 是否自动计算表格各列宽度 |
bDeferRender | trueorfalse,defaultfalse | 用于渲染的一个参数 |
bFilter | trueorfalse,defaulttrue | 开关,是否启用客户端过滤功能 |
bInfo | trueorfalse,defaulttrue | 开关,是否显示表格的一些信息 |
bJQueryUI | trueorfalse,defaultfalse | 是否使用jqueryuithemeroller的风格 |
bLengthChange | trueorfalse,defaulttrue | 开关,是否显示一个每页长度的选择条(需要分页器支持) |
bPaginate | trueorfalse,defaulttrue | 开关,是否显示(使用)分页器 |
bProcessing | trueorfalse,defualtfalse | 开关,以指定当正在处理数据的时候,是否显示“正在处理”这个提示信息 |
bScrollInfinite | trueorfalse,defaultfalse | 开关,以指定是否无限滚动(与sScrollY配合使用),在大数据量的时候很有用。当这个标志为true的时候,分页器就默认关闭 |
bSort | trueorfalse,defaulttrue | 开关,是否让各列具有按列排序功能 |
bSortClasses | trueorfalse,defaulttrue | 开关,指定当当前列在排序时,是否增加classes'sorting_1','sorting_2'and'sorting_3',打开后,在处理大数据时,性能有所损失 |
bStateSave | trueorfalse,defaultfalse | 开关,是否打开客户端状态记录功能。这个数据是记录在cookies中的,打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的 |
sScrollX | 'disabled'or'100%'类似的字符串 | 是否开启水平滚动,以及指定滚动区域大小 |
sScrollY | 'disabled'or'200px'类似的字符串 | 是否开启垂直滚动,以及指定滚动区域大小 |
-- | -- | -- |
选项 | ||
aaSorting | arrayarray[int,string],如[],[[0,'asc'],[0,'desc']] | 指定按多列数据排序的依据 |
aaSortingFixed | 同上 | 同上。唯一不同点是不能被用户的自定义配置冲突 |
aLengthMenu | default[10,25,50,100],可以为一维数组,也可为二维数组,比如:[[10,25,50,-1],[10,25,50,"All"]] | 这个为选择每页的条目数,当使用一个二维数组时,二维层面只能有两个元素,第一个为显示每页条目数的选项,第二个是关于这些选项的解释 |
aoSearchCols | defaultnull,类似:[null,{"sSearch":"Myfilter"},null,{"sSearch":"^[0-9]","bEscapeRegex":false}] | 给每个列单独定义其初始化搜索列表特性(这一块还没搞懂) |
asStripClasses | default['odd','even'],比如['strip1','strip2','strip3'] | 指定要被应用到各行的class风格,会自动循环 |
bDestroy | trueorfalse,defaultfalse | 用于当要在同一个元素上执行新的dataTable绑定时,将之前的那个数据对象清除掉,换以新的对象设置 |
bRetrieve | trueorfalse,defaultfalse | 用于指明当执行dataTable绑定时,是否返回DataTable对象 |
bScrollCollapse | trueorfalse,defaultfalse | 指定适当的时候缩起滚动视图 |
bSortCellsTop | trueorfalse,defaultfalse | (未知的东东) |
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字符串,defaultnull | 指定要从哪个URL获取数据 |
sCookiePrefix | 字符串,default'SpryMedia_DataTables_' | 当打开状态存储特性后,用于指定存储在cookies中的字符串的前缀名字 |
sDom | defaultlfrtip(whenbJQueryUIisfalse)or<"H"lfr>t<"F"ip>(whenbJQueryUIistrue) | 这是用于定义DataTable布局的一个强大的属性,另开专门文档来补充说明吧 |
sPaginationType | 'full_numbers'or'two_button',default'two_button' | 用于指定分页器风格 |
sScrollXInner | stringdefault'disabled' | 又是水平滚动相关的,没搞懂啥意思 |
回调函数名称 | 参数 | 返回值 | 默认 | 功能 |
fnCookieCallback | 1.string: NameofthecookiedefinedbyDataTables2.object:Datatobestoredin thecookie3.string:Cookieexpiresstring4.string:Pathofthecookie toset | string:cookieformattedstring(whichshouldbeencodedbyusingencodeURIComponent()) | null | 当每次cookies改变时,会触发这个函数调用 |
fnDrawCallback | 无 | 无 | 无 | 在每次table被draw完后调用,至于做什么就看着办吧 |
fnFooterCallback | 1.node: "TR"elementforthefooter2.arrayarraystrings:Fulltabledata(as derivedfromtheoriginalHTML)3.int:Indexforthecurrentdisplay startingpointinthedisplayarray<4.int :Indexforthecurrentdisplayendingpointinthedisplayarray 5.arrayint:Indexarraytotranslatethevisualpositiontothefull dataarray | 无 | 无 | 用于在每次重画的时候修改表格的脚部 |
fnFormatNumber | 1.int:numbertobeformatted | String:formattedstringforDataTablestoshowthenumber | 有默认的 | 用于在大数字上,自动加入一些逗号,分隔开 |
fnHeaderCallback | 1.node: "TR"elementfortheheader2.arrayarraystrings:Fulltabledata(as derivedfromtheoriginalHTML)3.int:Indexforthecurrentdisplay startingpointinthedisplayarray4.int :Indexforthecurrentdisplayendingpointinthedisplayarray 5.arrayint:Indexarraytotranslatethevisualpositiontothefull dataarray | 无 | 无 | 用于在每次draw发生时,修改table的header |
fnInfoCallback | 1.object: DataTablessettingsobject2.int:Startingpositionindataforthe draw3.int:Endpositionindataforthedraw4.int:Totalnumberof rowsinthetable(regardlessoffiltering)5.int: Totalnumberofrowsinthedataset,afterfiltering6.string:The stringthatDataTableshasformattedusingit'sownrules | string:Thestringtobedisplayedintheinformationelement. | 无 | 用于传达table信息 |
fnInitComplete | 1.object:oSettings-DataTablessettingsobject | 无 | 无 | 表格初始化完成后调用 |
fnPreDrawCallback | 1.object:oSettings-DataTablessettingsobject | Boolean | 无 | 用于在开始绘制之前调用,返回false的话,会阻止draw事件发生;返回其它值,draw可以顺利执行 |
fnRowCallback | 1.node: "TR"elementforthecurrentrow2.arraystrings:Rawdataarrayfor thisrow(asderivedfromtheoriginalHTML)3.int:Thedisplayindex forthecurrenttabledraw4.int:Theindex ofthedatainthefulllistofrows(afterfiltering) | node:"TR"elementforthecurrentrow | 无 | 当创建了行,但还未绘制到屏幕上的时候调用,通常用于改变行的class风格 |
fnServerData | 1.string: HTTPsourcetoobtainthedatafrom(i.e.sAjaxSource)2.arrayobjects: Akey/valuepairobjectcontainingthedatatosendtotheserver 3.function:Functiontobecalledoncompletion ofthedatagetprocessthatwilldrawthedataonthepage. | void | $.getJSON | 用于替换默认发到服务端的请求操作 |
fnStateLoadCallback | 1.object:oSettings -DataTablessettingsobject2.object:oData-Objectcontaining informationretrievedfromthestatesavingcookiewhichshouldbe restored.Fortheexactpropertiesplease refertotheDataTablescode. | Boolean-falseifthestateshouldnotbeloaded,trueotherwise | 无 | 在cookies中的数据被加载前执行,可以方便地修改这些数据 |
fnStateSaveCallback | 1.object:oSettings -DataTablessettingsobject2.String:sValue-aJSONstring(without thefinalclosingbrace)whichshouldbestoredinthestatesaving cookie. | String-thefullstringthatshouldbeusedtosavethestate | 无 | 在状态数据被存储到cookies前执行,可以方便地做一些预操作 |
注意,红框表示了四个默认的设置效果,分别用来选择每页的行数,表格的过滤器,表格的信息和换页。
此时,使用了几个默认的参数设置。在dataTables中,参数名称的前缀用来说明参数的数据类型,很明显,b表示布尔类型,i表示整数类型,s表示字符串类型。
bPaginate:是否分页,默认为true,分页
iDisplayLength:每页的行数,每页默认数量:10
sPaginationType:分页样式,支持两种内置方式,two_button和full_numbers,默认使用two_button。
bLengthChange:是否允许用户通过一个下拉列表来选择分页后每页的行数。行数为10,25,50,100。这个设置需要bPaginate支持。默认为true。
bFilter:启用或禁止数据过滤,默认为true。注意,如果使用过滤功能,但是希望关闭默认的过滤输入框,应使用sDom
bInfo:允许或者禁止表信息的显示,默认为true,显示信息。
我们也可以通过传递一个初始化参数对象来改变这些设置。例如,下面的例子将每页的行数设置为20行。
$( function () { |
$( "#example" ).dataTable( |
{ |
iDisplayLength: 20 |
} |
); |
});
原文转载:http://blog.csdn.net/cdefg198/article/details/7182341
相关文章推荐
- jquery 获取鼠标坐标
- jquery插件之拖拽
- Jquery+Json+ajax实现异步查询显示数据
- 纯js与jquery两种方法,获得某元素同级节点内容,进行值替换
- 说说JSON和JSONP,也许你会豁然开朗,含jQuery用例
- jquery的ajax和getJson跨域获取json数据
- jQuery的css()方法
- jquery获取radio选中的值
- jquery获取select选中的值
- jQuery 如何写插件 - 第二步
- jquery的使用
- 用jQuery在IFRAME里取得父窗口的某个元素的值
- jquery和zepto data() 读取和设置data-XX
- jQuery基础
- jquery 事件
- 【mark】datetimepicker 使用
- JQuery阻止冒泡事件on绑定中异常情况分析
- 关于jQuery版本不同而产生的问题、写法的记录
- jquery的智能提示控件
- jQuery 清除div内容