`

jquery插件之DataTables

阅读更多

DataTables(http://www.datatables.net/)应该是我到目前为止见过的,功能最强大的表格解决方案(当然,不计算其它整套框架中的table控件在内)。 

先把它主页上写的特性翻译罗列如下: 

  • 可变长度分页;
  • 动态过滤;
  • 多列排序,带数据类型检测功能;
  • 列宽度的智能处理;
  • 从多种数据源获取数据(DOM,js Array, ajax file, server-side returning);
  • 滚动配置属性;
  • 完整国际化支持;
  • jquery UI ThemeRoller支持;
  • 经历了个2600多个单元测试,相当牢固;
  • 有为数不少的插件支持;
  • 免费的;
  • 状态保存能力;
  • 支持隐藏列;
  • 动态创建表格的能力;
  • 自动ajax数据加载;
  • 自定义DOM位置;
  • 单列过滤(这个与前面的过滤有区别么?);
  • 多种分页器;
  • 无损的DOM交互;
  • 参与排序的列高亮;
  • 高级数据源配置;
  • 扩展的插件支持功能;
  • 可以用css完全配置表象;
  • 丰富的文档;
  • 110多个例子;
  • 对Adobe AIR的完全支持。



引入 

使用 

$(document).ready(function(){  
    $('#example').dataTable();  
});  
  
// 另一个例子  
$(document).ready(function(){  
    $('#example').dataTable({  
        "bInfo": false  
    });  
});  

 

要注意的是,要被dataTable处理的table对象,必须有thead与tbody,而且,结构要规整(数据不一定要完整),这样才能正确处理。 

以下是在进行dataTable绑定处理时候可以附加的参数: 

属性名称 取值范围 解释
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' 又是水平滚动相关的,没搞懂啥意思



DataTable支持如下回调函数 

回调函数名称 参数 返回值 默认 功能
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前执行,可以方便地做一些预操作

分享到:
评论

相关推荐

    jquery 分页插件 dataTables

    **jQuery分页插件dataTables详解** jQuery分页插件dataTables是一款强大的、灵活的、功能丰富的表格增强工具,它...在实际应用中,还可以结合其他jQuery插件或自定义JavaScript代码,实现更复杂的功能和定制化设计。

    Datatables jquery表格插件

    Datatables是一款基于jQuery的开源表格插件,广泛应用于网页数据展示和管理。它以其丰富的功能、高度的灵活性和良好的社区支持而备受青睐。这个插件的主要目标是将静态或者动态生成的HTML表格转变为具有强大交互性的...

    DONET的JQuery.Datatables集成插件(Mvc.JQuery.Datatables)

    【标题】:“DONET的JQuery.Datatables集成插件(Mvc.JQuery.Datatables)” 在.NET开发中,特别是使用ASP.NET MVC框架时,数据展示是一个常见的需求。`Mvc.JQuery.Datatables`是一个非常实用的插件,它允许开发者...

    jQuery表格插件DataTables

    **jQuery表格插件DataTables详解** DataTables是jQuery的一个强大插件,专为HTML表格提供高级功能和交互性。这个插件的核心理念是基于渐进增强的原理,即在基本HTML表格的基础上添加丰富的功能和控制,使得数据展示...

    jquery datatables 所需文件 官方下载的

    **jQuery DataTables 知识点详解** `jQuery DataTables` 是一个强大且功能丰富的JavaScript库,用于将HTML表格转化为交互式的数据展示工具。这个库基于jQuery框架,提供了数据排序、搜索、分页以及多种自定义功能,...

    jquery.dataTables.min.js

    jquery.dataTables.min.js是使用Datatable插件时用的脚本文件

    DataTables - jQuery表格插件

    DataTables是一款基于jQuery库的强大的表格插件,它极大地增强了HTML表格的功能,提供了丰富的排序、搜索、分页、列操作等交互性功能。这个插件的设计目标是为开发者提供一个高度可定制、易于使用的工具,使得网页上...

    jquery.dataTables包.rar

    《jQuery DataTables插件详解与应用》 jQuery DataTables 是一款功能强大的JavaScript表格插件,它..."jquery.dataTables包.rar" 提供了集成DataTables所需的基础资源,只需简单引用,即可开启高效的数据管理之旅。

    jQuery datatables插件

    **jQuery DataTables 插件详解** jQuery DataTables 是一个强大且功能丰富的JavaScript库,用于将HTML表格转化为交互式数据展示工具。它支持多种高级功能,包括数据排序、列过滤、隐藏列以及更多自定义选项,使得...

    jquery 插件DataTable 最新版本下载

    **jQuery插件DataTable详解** DataTable是一款非常流行的jQuery插件,专为HTML表格提供高级功能,如数据排序、过滤、分页以及自定义显示等。它极大地增强了网页中的表格交互性,使得用户能够更加便捷地管理和操作...

    仿jquery.dataTables的分页(查询+排序)

    仿jquery.dataTables的分页(查询+排序),jquery插件式开发简单示例。

    jquery-dataTables简单实例

    jQuery DataTables 是一个高度可配置的表格插件,它为HTML表格提供了丰富的功能,如排序、过滤、分页和数据导出等。在这个实例中,我们将深入理解如何使用jQuery DataTables创建简单但实用的数据展示。 1. **基本...

    jquery-datatables-rails, 用于 Rails的jquery数据表 gem.zip

    jquery-datatables-rails, 用于 Rails的jquery数据表 gem jquery-datatables-rails 这个 gem 为 jQuery DataTables插件提供了方便,以便与 Rails 资产pipleine结合使用。 它提供所有基本的datatable文件,以及一些...

    jquery dataTables及相关css

    它是一个强大的jQuery插件,能够将普通的HTML表格转化为具有高级搜索、排序、分页等功能的数据视图。在提供的文件中,`jquery.dataTables.js`和`jquery.dataTables-1.7.5.js`是两个主要的JavaScript库,分别代表了...

    jquery 表格分页处理插件 DataTables

    DataTables是提供了大量特性的强大jQuery表格插件。例如:你可以自动轻松筛选、Ajax预读取数据、分页、列排序、高亮排序列、扩展插件支持、使用CSS或jQuery UI ThemeRoller 定制主题和完整文档。

    jQuery+datatables插件实现ajax加载数据与增删改查功能示例

    1. jQuery+datatables插件实现:这是指使用jQuery结合datatables插件来实现特定的网页表格功能,例如数据的动态加载、分页、排序等。 2. ajax加载数据:涉及通过ajax技术从服务器端动态获取数据,并在网页上实时...

    jQuery表格插件datatables用法详解

    Datatables 是一个强大的 jQuery 表格插件,它提供了丰富的功能,如分页、排序、过滤、自定义样式等,使HTML表格具有更高级的交互性。以下是对 Datatables 插件用法的详细说明: 1. **Datatables 简介**: ...

    ASP.NET-Core-2-MVC-CRUD-datatables-jQuery-Plugin:Asp.Net使用Asp.Net Core 2 Mvc CRUD数据表jQuery插件的datatables.net示例实现

    你会学什么ASP.NET Core 2 使用ASP.NET Core 2的Web API 使用实体框架(EF)的CRUD 代码优先项目中使用的jQuery插件datatables.net(用于呈现网格) serializeJSON(用于从FORM到JSON的自动序列化) 烤面包机(用于...

    很好用的Jquery插件

    本文将深入探讨“很好用的Jquery插件”,并介绍几个常用插件及其简单使用方法,这对于在项目中提升用户体验具有显著帮助。 首先,jQuery库的核心优势在于它的API设计,它提供了丰富的选择器、DOM操作、事件处理和...

    jQuery插件datatables使用教程

    jQuery 的插件 dataTables 是一个优秀的表格插件,提供了针对表格的排序、浏览器分页、服务器分页、筛选、格式化等功能。接下来通过本文给大家介绍jQuery插件datatables使用教程,感兴趣的朋友一起学习吧

Global site tag (gtag.js) - Google Analytics