热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

DataTables插件介绍及使用方法

本文介绍了DataTables插件的官方网站以及其基本特点和使用方法,包括分页处理、数据过滤、数据排序、数据类型检测、列宽度自动适应、CSS定制样式、隐藏列等功能。同时还介绍了其易用性、可扩展性和灵活性,以及国际化和动态创建表格的功能。此外,还提供了参数初始化和延迟加载的示例代码。

官方网站: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
  });
});


属性名称取值范围解释
bAutoWidthtrue or false, default true是否自动计算表格各列宽度
bDeferRendertrue or false, default false用于渲染的一个参数
bFiltertrue or false, default true开关,是否启用客户端过滤功能
bInfotrue or false, default true开关,是否显示表格的一些信息
bJQueryUItrue or false, default false是否使用jquery ui themeroller的风格
bLengthChangetrue or false, default true开关,是否显示一个每页长度的选择条(需要分页器支持)
bPaginatetrue or false, default true开关,是否显示(使用)分页器
bProcessingtrue or false, defualt false开关,以指定当正在处理数据的时候,是否显示“正在处理”这个提示信息
bScrollInfinitetrue or false, default false开关,以指定是否无限滚动(与sScrollY配合使用),在大数据量的时候很有用。当这个标志为true的时候,分页器就默认关闭
bSorttrue or false, default true开关,是否让各列具有按列排序功能
bSortClassestrue or false, default true开关,指定当当前列在排序时,是否增加classes ‘sorting_1′, ‘sorting_2′ and ‘sorting_3’,打开后,在处理大数据时,性能有所损失
bStateSavetrue or false, default false开关,是否打开客户端状态记录功能。这个数据是记录在COOKIEs中的,打开了这个记录后,即使刷新一次页面,或重新打开浏览器,之前的状态都是保存下来的
sScrollX‘disabled’ or  ‘100%’ 类似的字符串是否开启水平滚动,以及指定滚动区域大小
sScrollY‘disabled’ or ‘200px’ 类似的字符串是否开启垂直滚动,以及指定滚动区域大小
选项

aaSortingarray array[int,string], 如[], [[0,’asc’], [0,’desc’]]指定按多列数据排序的依据
aaSortingFixed同上同上。唯一不同点是不能被用户的自定义配置冲突
aLengthMenudefault [10, 25, 50, 100],可以为一维数组,也可为二维数组,比如:[[10, 25, 50, -1], [10, 25, 50, “All”]]这个为选择每页的条目数,当使用一个二维数组时,二维层面只能有两个元素,第一个为显示每页条目数的选项,第二个是关于这些选项的解释
aoSearchColsdefault null, 类似:[null, {“sSearch”: “My filter”}, null,{“sSearch”: “^[0-9]”, “bEscapeRegex”: false}]给每个列单独定义其初始化搜索列表特性(这一块还没搞懂)
asStripClassesdefault [‘odd’, ‘even’], 比如[‘strip1′, ‘strip2′, ‘strip3′]指定要被应用到各行的class风格,会自动循环
bDestroytrue or false, default false用于当要在同一个元素上执行新的dataTable绑定时,将之前的那个数据对象清除掉,换以新的对象设置
bRetrievetrue or false, default false用于指明当执行dataTable绑定时,是否返回DataTable对象
bScrollCollapsetrue or false, default false指定适当的时候缩起滚动视图
bSortCellsToptrue 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’指定当从服务端获取表格数据时,数据项使用的名字
sAjaxSourceURL字符串,default null指定要从哪个URL获取数据
sCOOKIEPrefix字符串,default ‘SpryMedia_DataTables_’当打开状态存储特性后,用于指定存储在COOKIEs中的字符串的前缀名字
sDomdefault 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’用于指定分页器风格
sScrollXInnerstring default ‘disabled’又是水平滚动相关的,没搞懂啥意思


回调函数名称参数返回值默认功能
fnCOOKIECallback1.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完后调用,至于做什么就看着办吧
fnFooterCallback1.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
用于在每次重画的时候修改表格的脚部
fnFormatNumber1.int : number to be formattedString : formatted string for DataTables to show the number有默认的用于在大数字上,自动加入一些逗号,分隔开
fnHeaderCallback1.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
fnInfoCallback1.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信息
fnInitComplete1.object:oSettings – DataTables settings object表格初始化完成后调用
fnPreDrawCallback1.object:oSettings – DataTables settings objectBoolean用于在开始绘制之前调用,返回false的话,会阻止draw事件发生;返回其它值,draw可以顺利执行
fnRowCallback1.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风格
fnServerData1.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用于替换默认发到服务端的请求操作
fnStateLoadCallback1.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中的数据被加载前执行,可以方便地修改这些数据
fnStateSaveCallback1.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看一下控件会向服务端传递什么:

了解DataTables


这是底部的分页栏

了解DataTables


当我点第二页时,传递参数如下:

了解DataTables

注意到iDisplayLength10,因为我默认是每页展示10条数据,这个值可以调整。当我点第二页时,iDisplayStart0变到10。其实分页就是这么回事,前端告诉服务端,我需要那段数据,你给我找出来返回给我。


服务端的返回格式如下(PHP):

$ret = array(
                "sEcho" => intval($_GET['sEcho']),
                "iTotalRecords" => $data_count,
                "iTotalDisplayRecords" => $data_count,
                "aaData" => array()
            );



推荐阅读
  • 本文将介绍如何编写一些有趣的VBScript脚本,这些脚本可以在朋友之间进行无害的恶作剧。通过简单的代码示例,帮助您了解VBScript的基本语法和功能。 ... [详细]
  • 本文介绍了一款用于自动化部署 Linux 服务的 Bash 脚本。该脚本不仅涵盖了基本的文件复制和目录创建,还处理了系统服务的配置和启动,确保在多种 Linux 发行版上都能顺利运行。 ... [详细]
  • 2023 ARM嵌入式系统全国技术巡讲旨在分享ARM公司在半导体知识产权(IP)领域的最新进展。作为全球领先的IP提供商,ARM在嵌入式处理器市场占据主导地位,其产品广泛应用于90%以上的嵌入式设备中。此次巡讲将邀请来自ARM、飞思卡尔以及华清远见教育集团的行业专家,共同探讨当前嵌入式系统的前沿技术和应用。 ... [详细]
  • 技术分享:从动态网站提取站点密钥的解决方案
    本文探讨了如何从动态网站中提取站点密钥,特别是针对验证码(reCAPTCHA)的处理方法。通过结合Selenium和requests库,提供了详细的代码示例和优化建议。 ... [详细]
  • 本文详细介绍了如何解决Uploadify插件在Internet Explorer(IE)9和10版本中遇到的点击失效及JQuery运行时错误问题。通过修改相关JavaScript代码,确保上传功能在不同浏览器环境中的一致性和稳定性。 ... [详细]
  • Linux 系统启动故障排除指南:MBR 和 GRUB 问题
    本文详细介绍了 Linux 系统启动过程中常见的 MBR 扇区和 GRUB 引导程序故障及其解决方案,涵盖从备份、模拟故障到恢复的具体步骤。 ... [详细]
  • 导航栏样式练习:项目实例解析
    本文详细介绍了如何创建一个具有动态效果的导航栏,包括HTML、CSS和JavaScript代码的实现,并附有详细的说明和效果图。 ... [详细]
  • 1:有如下一段程序:packagea.b.c;publicclassTest{privatestaticinti0;publicintgetNext(){return ... [详细]
  • PHP 5.2.5 安装与配置指南
    本文详细介绍了 PHP 5.2.5 的安装和配置步骤,帮助开发者解决常见的环境配置问题,特别是上传图片时遇到的错误。通过本教程,您可以顺利搭建并优化 PHP 运行环境。 ... [详细]
  • 深入理解Cookie与Session会话管理
    本文详细介绍了如何通过HTTP响应和请求处理浏览器的Cookie信息,以及如何创建、设置和管理Cookie。同时探讨了会话跟踪技术中的Session机制,解释其原理及应用场景。 ... [详细]
  • 使用 Azure Service Principal 和 Microsoft Graph API 获取 AAD 用户列表
    本文介绍了一段通用代码示例,该代码不仅能够操作 Azure Active Directory (AAD),还可以通过 Azure Service Principal 的授权访问和管理 Azure 订阅资源。Azure 的架构可以分为两个层级:AAD 和 Subscription。 ... [详细]
  • 前言--页数多了以后需要指定到某一页(只做了功能,样式没有细调)html ... [详细]
  • 本文详细介绍了Java编程语言中的核心概念和常见面试问题,包括集合类、数据结构、线程处理、Java虚拟机(JVM)、HTTP协议以及Git操作等方面的内容。通过深入分析每个主题,帮助读者更好地理解Java的关键特性和最佳实践。 ... [详细]
  • 尽管某些细分市场如WAN优化表现不佳,但全球运营商路由器和交换机市场持续增长。根据最新研究,该市场预计在2023年达到202亿美元的规模。 ... [详细]
  • 几何画板展示电场线与等势面的交互关系
    几何画板是一款功能强大的物理教学软件,具备丰富的绘图和度量工具。它不仅能够模拟物理实验过程,还能通过定量分析揭示物理现象背后的规律,尤其适用于难以在实际实验中展示的内容。本文将介绍如何使用几何画板演示电场线与等势面之间的关系。 ... [详细]
author-avatar
顾久君_152_599
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有