Datatables 1.10.x在命名上与1.9.x的有区别,新版的使用的是驼峰的命名规则,而以前的是采用匈牙利命名规则 css
固然,这些变化都是向下兼容的,你能够继续使用旧版本的api方法的参数和名称。 若是你要是用新版本的api方法,请参考下面表格的对照表,大多数的都是直接从匈牙利命名到驼峰命名,极个别重命名,还添加了新的属性名称。 html
如今能够这样建立一个Datatables: node
$(...).dataTable()建立一个Datatables并返回一个jquery对象(1.9-) jquery
$(...).DataTable()建立一个Datatables并返回一个新的Datatables API实例 ajax
两种方法均可以在1.10+版本中使用 api
匈牙利式 | 驼峰式 | 含义 |
---|---|---|
aaData | dataDT | 给表格显示数据 |
aaSorting | orderDT | 表格初始化排序 |
aaSortingFixed | orderFixedDT | Ordering to always be applied to the table |
aDataSort | columns.orderDataDT | 定义多个列做为列的默认顺序 |
aLengthMenu | lengthMenuDT | 改变每页显示条数列表的选项 |
aTargets | columnDefs.targetsDT | 适用于指定一个特定的列 |
aoColumns | columnsDT | 列配置数组 |
aoColumnDefs | columnDefsDT | 列定义配置数组 |
aoSearchCols | searchColsDT | 给个别列定义搜索选项 |
asSorting | columns.orderSequenceDT | 指定排序 |
asStripeClasses | stripeClassesDT | 在表中设置斑马条纹类的行 |
bAutoWidth | autoWidthDT | 让Datatables自动计算宽度 |
bDeferRender | deferRenderDT | 延迟渲染能够提升Datatables的加载速度 |
bDestroy | destroyDT | 容许从新实例化Datatables |
bFilter | searchingDT | 开启搜索功能 |
bInfo | infoDT | 开启Datatables信息显示 |
bJQueryUI | jQueryUIDT | 使用jqueryui样式(须要引入jqueryui的css) |
bLengthChange | lengthChangeDT | 容许改变每页显示的数据条数 |
bPaginate | pagingDT | 容许表格分页 |
bProcessing | processingDT | 显示加载信息 |
bRetrieve | retrieveDT | 检索一个已存在的Datatables实例 |
bScrollAutoCss | 废弃 | |
bScrollCollapse | scrollCollapseDT | 开启滚动条 |
bScrollInfinite | 废弃 | |
bSearchable | columns.searchableDT | 定义列是否容许搜索 |
bServerSide | serverSideDT | 开启服务器模式 |
bSort | orderingDT | 是否启用Datatables排序 |
bSortable | columns.orderableDT | 开启或关闭某列的排序 |
bSortCellsTop | orderCellsTopDT | Control which cell the order event handler will be applied to in a column |
bSortClasses | orderClassesDT | 排序列高亮显示 |
bStateSave | stateSaveDT | 容许浏览器缓存Datatables,以便下次恢复以前的状态 |
bUseRendered | 废弃 | Use columns.renderDT |
bVisible | columns.visibleDT | 列是否显示 |
fnCookieCallback | 废弃 | |
fnCreatedCell | columns.createdCellDT | 单元格被建立回调函数,容许dom操做 |
fnCreatedRow | createdRowDT | tr被建立回调函数 |
fnDrawCallback | drawCallbackDT | 表格重绘的时候回调函数 |
fnFooterCallback | footerCallbackDT | foot显示回调函数 |
fnFormatNumber | formatNumberDT | 数字格式化回调函数 |
fnHeaderCallback | headerCallbackDT | thead显示回调函数 |
fnInfoCallback | infoCallbackDT | 表格主要信息显示回调函数 |
fnInitComplete | initCompleteDT | 表格加载完成回调函数 |
fnPreDrawCallback | preDrawCallbackDT | 预绘制回调函数 |
fnRender | 废弃 | Use columns.renderDT |
fnRowCallback | rowCallbackDT | 行重绘回调 |
fnServerData | ajaxDT | 从 Ajax 源加载数据的表的内容 |
fnServerParams | ajaxDT | 从 Ajax 源加载数据的表的内容 |
fnStateLoad | stateLoadCallbackDT | 定义在何处以及如何应加载已保存的状态的回调 |
fnStateLoaded | stateLoadedDT | 状态被读取回调 |
fnStateLoadParams | stateLoadParamsDT | 加载状态,数据操做回调 |
fnStateSave | stateSaveCallbackDT | 定义如何存和在哪里储表状态回调 |
fnStateSaveParams | stateSaveParamsDT | 状态保存,数据操做回调 |
iCookieDuration | stateDurationDT | 状态保存的有效期 |
iDataSort | columns.orderDataDT | 定义多个列做为列的默认顺序 |
iDeferLoading | deferLoadingDT | 延迟加载服务器端数据直到第二次重绘 |
iDisplayLength | pageLengthDT | 更改初始页面长度 (每页的行数) |
iDisplayStart | displayStartDT | 初始分页起始点 |
iScrollLoadGap | 废弃 | |
iTabIndex | tabIndexDT | 选项卡索引控件的键盘导航 |
mData | columns.dataDT | 从行数据对象/数组设置列的数据源 |
mRender | columns.renderDT | Render (process) the data for use in the table |
oLanguage.oAria.sSortAscending | language.aria.sortAscendingDT | 用于WAI-ARIA(无障碍网页应用)属性 |
oLanguage.oAria.sSortDescending | language.aria.sortDescendingDT | 用于WAI-ARIA(无障碍网页应用)属性 |
oLanguage.oPaginate.sFirst | language.paginate.firstDT | 翻页中“首页”字符串 |
oLanguage.oPaginate.sLast | language.paginate.lastDT | 翻页中“尾页”字符串 |
oLanguage.oPaginate.sNext | language.paginate.nextDT | 翻页中“下一页”字符串 |
oLanguage.oPaginate.sPrevious | language.paginate.previousDT | 翻页中“上一页”字符串 |
oLanguage.sEmptyTable | language.emptyTableDT | 表格中没有数据时显示的字符串 |
oLanguage.sInfo | language.infoDT | 表格主要信息显示字符串 |
oLanguage.sInfoEmpty | language.infoEmptyDT | 当表格没有数据和搜索记录时,表格主要信息显示字符串 |
oLanguage.sInfoFiltered | language.infoFilteredDT | 当使用搜索功能后,表格主要信息出追加的字符 |
oLanguage.sInfoPostFix | language.infoPostFixDT | 追加到全部其余主要信息字符串以后 |
oLanguage.sInfoThousands | language.thousandsDT | 千分位分隔符 |
oLanguage.sLengthMenu | language.lengthMenuDT | 页面显示数据条数选项 |
oLanguage.sLoadingRecords | language.loadingRecordsDT | 当ajax加载数据时-加载信息显示字符串 |
oLanguage.sProcessing | language.processingDT | 显示正在处理字符串 |
oLanguage.sSearch | language.searchDT | 搜索框显示字符串 |
oLanguage.sUrl | language.urlDT | 从远程加载语言信息文件url |
oLanguage.sZeroRecords | language.zeroRecordsDT | 过滤后空的结果字符串 |
oSearch | searchDT | 设置一个在Datatables初始化时的搜索选项 |
sAjaxDataProp | ajax.dataSrcDT | 表数据的数据属性或操做方法 |
sAjaxSource | ajaxDT | 从 Ajax 源加载数据的表的内容 |
sCellType | columns.cellTypeDT | 要为列建立的单元格类型 |
sClass | columns.classNameDT | 指定单元格样式 |
sContentPadding | contentPaddingDT | 给文本内容添加填充被用来计算最合适的表格 |
sCookiePrefix | 废弃 | |
sDefaultContent | columns.defaultContentDT | 给列设置默认的,静态的内容 |
sDom | domDT | 按什么顺序定义表的控制元素在页面上出现 |
sName | columns.nameDT | 设置列的描述性名称 |
sPaginationType | pagingTypeDT | 分页按钮种类显示选项 |
sScrollX | scrollXDT | 水平滚动条 |
sScrollXInner | scrollXInner | 没有文档在1.10中 |
sScrollY | scrollYDT | 垂直滚动条 |
sServerMethod | ajaxDT | 从 Ajax 源加载数据的表的内容的方式 |
sSortDataType | columns.orderDataTypeDT | Live DOM sorting type assignment |
sTitle | columns.titleDT | 给列设置名称 |
sType | columns.typeDT | 设置用于筛选和排序字符串处理的列类型 |
sWidth | columns.widthDT | 设置列宽 |
如下是旧的api转换新的,新的api有不少,下面没有所有列出来。关于如何使用它,请参考api完整信息。 数组
匈牙利式 | 驼峰式 | 含义 |
---|---|---|
$ | $DT | Perform a jQuery selection action on the full table. |
_ | row().data()DT, rows().data()DT, cell().data()DT | 从行、列和单元格中获取数据 |
fnAddData | row.add()DT, rows.add()DT | 给表格添加一行或多行 |
fnAdjustColumnSizing | columns.adjust()DT | 从新计算列的宽度 |
fnClearTable | clear()DT | 清除表格的全部数据 |
fnClose | row().child.hide()DT | 隐藏父行的子行 |
fnDeleteRow | row().remove()DT, rows().remove()DT | 从Datatables删掉一行或或者更多 |
fnDestroy | destroy()DT | 从当前上下文销毁掉Datatables对象 |
fnDraw | draw()DT | 重绘表格 |
fnFilter | search()DT, column().search()DT, columns().search()DT | 从表格里搜索数据 |
fnGetData | row().data()DT, rows().data()DT, cell().data()DT | 从列,行,单元格中获取数据 |
fnGetNodes | row().node()DT, rows().nodes()DT, cell().node()DT | 从列,行和单元格里获取节点 |
fnGetPosition | row().index()DT, cell.index()DT | 获取有关选定的行、 列或单元格的索引信息 |
fnIsDataTable | $.fn.dataTable.isDataTable()DT | 检查表格的节点是否是Datatable对象 |
fnIsOpen | row().child.isShown()DT | 检查子行的父行是否可见 |
fnOpen | row().child()DT | 使父行的子行可见 |
fnPageChange | page()DT | 获取/设置表的当前页 |
fnSetColumnVis | column().visible()DT | 获取/设置单个所选列的可见性 |
fnSettings | settings()DT | 获取表的设置对象 |
fnSort | order()DT, column().order()DT | 选择指定列排序 |
fnSortListener | order.listener()DT | 给指定的列添加排序的监听 |
fnTables | $.fn.dataTable.tables()DT | 在本页获得全部的Datatables |
fnUpdate | row().data()DT, cell().data()DT | 设置行或单元格的数据 |
fnVersionCheck | $.fn.dataTable.versionCheck()DT | 版本号码的兼容性检查功能 |
Translation from DataTables.net, with permission