DataTables控件详解附插图.docx
- 文档编号:5669415
- 上传时间:2022-12-31
- 格式:DOCX
- 页数:21
- 大小:62.39KB
DataTables控件详解附插图.docx
《DataTables控件详解附插图.docx》由会员分享,可在线阅读,更多相关《DataTables控件详解附插图.docx(21页珍藏版)》请在冰豆网上搜索。
DataTables控件详解附插图
datatables表格
并不是所有的后台开发都有美工和前端工程师来配合做页面,为了显示数据并有一定的美感,jQuery的DataTables插件对于像我这样的前端菜鸟来说真是雪中送炭,当然对于专业的前端开发者来说它更是锦上添花!
DataTables提供了针对表格的排序、浏览器分页、服务器分页、筛选、格式化、统计等强大功能。
工作中对程序员的学习模式才深有体会,不是从入门到精通,而是从会用到了解。
对于我来说,基本都是拿到一个知识先做个东西出来,再来细细品味个中的细节,然后再慢慢理解。
从粗到细,从大到小,呵呵,这种"逆向学习"的模式估计也只在互联网常见了。
使用前要引入datatables的相关包:
datatables表格展示以及数据源方式都有很多,这里用的是最常见的后端返回给前端的json格式的数据源,并且前端html里指定列的title。 后端的数据可以如下: app.get('/test/index',function(req,res){ vardata=[{name: 'xiaojie',age: 24,job: 'developer',description: 'humours'},{},{},{}];//格式像这样,数据省略 res.json({data: data}); }); html里仅仅声明一个table的框架: --自定义列--> 重头戏是js,这里有功能强大的字段,待我慢慢道来。 首先初始化一个datatables,最基本的就这样: $(document).ready(function(){ $('#datatables').dataTable({ }); }); datatables太强大,记录起来真是无处下手。 先来看个例子,然后再做详细介绍: $(document).ready(function(){ vartable=$('#datatables').DataTable({ "autoWidth": false, "paging": true, //"dom": 'T<"clear"><"toolbar">Clfrtip', "dom": 'iCflrtp', "iDisplayLength": 100, "lengthMenu": [[100,500,1000,-1],[100,500,1000,"所有"]], "tableTools": { "sSwfPath": "/js/datatables/tabletools/swf/copy_csv_xls_pdf.swf", "aButtons": [ {sExtends: "csv",oSelectorOpts: {page: "current"}}, "print"], "sRowSelect": "os", }, "stateSave": false, "processing": true, "ajax": { 'url': "/test/index", }, "order": [ [0,"asc"], [1,"asc"], [2,"desc"], ], "columnDefs": [ {width: '25%',targets: 3}, ], "columns": [{ "data": "name", },{ "data": "age", },{ "data": "job", },{ "data": "description", "visible": false }], "sPaginationType": "full_numbers", "oLanguage": { "sProcessing": " "sLengthMenu": "每页显示_MENU_条记录", "sZeroRecords": "抱歉,没有找到", "sInfo": "从_START_到_END_/共_TOTAL_条数据", "sInfoEmpty": "没有数据", "sInfoFiltered": "(从_MAX_条数据中检索)", "sZeroRecords": "没有检索到数据", "sSearch": "模糊查询: ", "oPaginate": { "sFirst": "首页", "sPrevious": "前一页", "sNext": "后一页", "sLast": "尾页" } }, }); 这里面每个字段都可以说上一番,有些简单很容易理解,像dom这种就很复杂。 展示的效果表格前面: 表格底部是分页: 然后说明一下每个字段的效果都体现在哪里 autoWidth 用来启用或禁用自动列的宽度计算。 通常被禁用作为优化(它需要一个有限的时间量来计算的宽度),默认值是true,所以通常将它设为false 分页paging 指定它才能显示表格底部的分页按钮,如果数据量大的话,这个通常需要设置为true,当然它也与dom的值息息相关,如果dom中没有指定p这个字符,它即使为true也是无效的。 dom 这个是我认为最复杂也是功能最强大的字段,当然目前我也只用到了它的冰山一角。 当自定义数据表时,可以根据自身喜好来设置功能元素的默认位置等,可以指定容器,由数据表给出每个HTML控制元件被表示为在domDT选项的单个字符。 dom常用的初始化字符如下: l-Lengthchanging选择每页显示行数下拉框的控件 f-Filteringinput搜索过滤控件 t-TheTabletools导出excel,csv的按钮 i-Information显示汇总信息(从1到100/共1,288条数据) p-Pagination分页控件 r-pRocessing显示加载时的进度条 C-copy显示复制,excel的控件 下面四种是在dom中在自定义的位置植入自定义元素和class <"class"and>-DIV和Class <"#id"and>-DIV和ID <"#id.class"and>-DIV和ID和Class 这些元素的先后顺序也决定了对应的控件在表格中显示的位置。 举个例子: "dom": 'i<"toolbar">TCflrtp', 则在汇总信息(i)左边定义了一个div: toolbar js如下: $("div.toolbar").html(" $(".add_server").click(function(){ location.href="/server/import" }) 即这是在汇总信息左边会出现一个按钮,点击跳转到另一个页面。 这种方式可以在一个集成的表格里植入自定义的东西,非常赞! 对于改变页面上元素的位置,我还愿意多举几个例子: example1: 简单的DIV和样式元素设置 /*Resultsin: {filter} {length} {information} {pagination} {table}姓名 年龄 JOB 描述 操作
*/
$('#example').dataTable({
"dom":
'<"wrapper"flipt>'
});
example2:
每页行数p,检索条件f,分页p在表格上面,表信息i在表格下面
/*Resultsin:
{length}
{filter}
{table}
{information}
{pagination}
*/
$('#example').dataTable({
"dom":
'
});
example3:
表信息i在表上面,检索条件f,每页行数p,处理中r在表下面,并且有清除元素
/*Resultsin:
{information}
{processing}
{table}
{filter}
{length}
{pagination}
*/
$('#example').dataTable({
"dom":
'<"top"i>rt<"bottom"flp><"clear">'
});
iDisplayLength和lengthMenu
这两个元素是和dom的l字符对应的,
"iDisplayLength":
100, ------表示默认1页是100行数据
"lengthMenu":
[[100,500,1000,-1],[100,500,1000,"所有"]], -------自定义每页显示的行数,
iDisplayLength默认是10行,lengthMenu默认是[[102550100],[102550100]]
tableTools
这个也有很多参数,这里只写了常见的。
swf可以导出为csv,pdf,xls三种文件,若需要一种,可以在aButtons中指定
"tableTools":
{
"sSwfPath":
"/js/datatables/tabletools/swf/copy_csv_xls_pdf.swf",
"aButtons":
[
{sExtends:
"csv",oSelectorOpts:
{page:
"current"},sFileName:
"test.csv",//导出为csv文件,并且指定了文件的名称
},
"print",//打印控件
"sRowSelect":
"os",
},
对应的表格控件为:
stateSave
如果设置为true这个是保存当前用户的状态的,比如用户选择当前每页显示500行,那么他重新刷页面这个不是默认的100行,而是记录了用户的行为显示500行。
processing
这个对应dom中的r,即加载数据时显示的进度,这个一般都设置为true,不然数据量大的话用户可能等上几秒却不知怎么回事,显示的控件如下:
ajax
即后端传来的数据,如果按照上述传来的数据格式的话,则下面的url就是后端指定的url:
"ajax":
{
'url':
"/test/index",
},
order
排序,这个可以对单列排序,可以按照指定的顺序,先按哪列排序再按哪列排序
"order":
[
[0,"asc"],
[1,"asc"],
[2,"desc"],
],
//表示先对第1列进行升序排序,再按照第二列升序排序,最后按照第三列降序排序
columnDefs
这个字段可以对列进行很多操作,这个字段也很复杂,功能强大
"columnDefs":
[
{width:
'25%',targets:
3},
],
上面举的例子的意思是对第四列的宽度设置占所有列宽度的25%,它还有很强大的功能,如改变某列元素的属性,增加列等,如下:
"columnDefs":
[
//将name列变为红色
{
"targets":
[0],//目标列位置,下标从0开始
"data":
"name",//数据列名
"render":
function(data,type,full){//返回自定义内容
return" red;'>"+data+""; } }, //增加一列,包括删除和修改,同时将需要传递的数据传递到链接中 { "targets": [4],//目标列位置,下标从0开始 "data": "name",//数据列名 "render": function(data,type,full){//返回自定义内容 return" name="+data+"'>删除 name="+data+"'>更新"; } } ] columns 这个指定了传过来的数据的字段,visible字段默认是true,如果设置false的话,显示的时候是隐藏的,当然也可以通过空间取消其隐藏。 sPaginationType sPaginationType: 分页样式,支持两种内置方式,two_button和full_numbers,默认使用two_button。 即下面两种方式: oLanguage 数据表的语言设置,默认都是英文的,可以通过修改下面源码的字段来修改成中文,更可以改为喜欢的展现方式。 另外有点想说明下,开始对于这些个字段的命名不太理解,原来第一个小写字母表示它接受参数的类型。 a: array s: string o: object "oLanguage": { "sProcessing": " "sLengthMenu": "每页显示_MENU_条记录", "sZeroRecords": "抱歉,没有找到", "sInfo": "从_START_到_END_/共_TOTAL_条数据", "sInfoEmpty": "没有数据", "sInfoFiltered": "(从_MAX_条数据中检索)", "sZeroRecords": "没有检索到数据", "sSearch": "模糊查询: ", "oPaginate": { "sFirst": "首页", "sPrevious": "前一页", "sNext": "后一页", "sLast": "尾页" } }, rowCallback 还有一个常用的是rowCallback,当创建了行,但还未绘制到屏幕上的时候调用,通常用于改变行的class风格。 比如为列为IP的这一行加个超链接,代码接着上面的: "rowCallback": function(row,data){//data是后端返回的数据 if(data.ip){ $('td: eq(3)',row).html(' //'+data.ip+'>'+data.ip+''); } }, //$('td: eq(3)',row)表示选中第四列的元素 则这样的话第四列的IP只要不为空值则都链接到自己的页面。 datatables实在太强大,太方便,我这里说的仍然是冰山一角,下面附录是摘自网上,常用的属性和方法 要注意的是,要被dataTable处理的table对象,必须有thead与tbody,而且,结构要规整(数据不一定要完整),这样才能正确处理。 以下是在进行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' 用于指定分