功能

放置在 DataTable 周围的表格控件和信息元素被称为“功能”,每个功能都有自己的配置选项。功能的放置由 layout 选项定义,其中每个插槽可以包含一个功能描述符。

DataTables 有四个内置功能

可以使用 DataTable.feature.register() 方法添加新功能,DataTables 的官方扩展广泛使用此方法。

以下选项显示 layout 选项用于禁用表格左上角的默认 pageLength 并将分页控件放置在右上角。

new DataTable('#myTable', {
    layout: {
        topStart: null
        topEnd: 'paging'
    }
} );
名称 摘要
内置 - 信息

info

表格信息显示

内置 - 信息

info.callback

信息显示回调

内置 - 信息

info.empty

空表格文本

内置 - 信息

info.postfix

信息字符串后缀

内置 - 信息

info.search

搜索活动时附加到信息字符串

内置 - 信息

info.text

表格摘要信息显示字符串

内置 - 页面长度

pageLength

分页长度控制

内置 - 页面长度

pageLength.menu

页面长度控制的文本

内置 - 页面长度

pageLength.text

页面长度控制的文本

内置 - 分页

paging

分页按钮

内置 - 分页

paging.boundaryNumbers

在数字中包含(或不包含)前导的第一页和最后一页。

内置 - 分页

paging.buttons

设置分页数字按钮的最大数量

内置 - 分页

paging.firstLast

在分页控件中包含(或不包含)第一个和最后一个按钮。

内置 - 分页

paging.numbers

在分页控件中包含(或不包含)数字。

内置 - 分页

paging.previousNext

在分页控件中包含(或不包含)上一个和下一个按钮。

内置 - 分页

paging.type

分页按钮显示选项

内置 - 搜索

search

全局搜索输入

内置 - 搜索

search.placeholder

输入元素的占位符

内置 - 搜索

search.processing

搜索时显示处理指示器

内置 - 搜索

search.text

搜索控件的文本

内置 - Div

div

文本/HTML 容器

内置 - Div

div.className

设置创建元素的类名。

内置 - Div

div.html

设置元素的 HTML 内容。

内置 - Div

div.id

设置创建元素的 ID。

内置 - Div

div.text

设置元素的文本内容。

按钮

buttons

表格控制按钮

按钮

buttons.buttons

要创建的按钮列表

按钮

buttons.buttons.action

按钮激活时要采取的操作

按钮

buttons.buttons.async

指示按钮的操作处理应该异步执行。

按钮

buttons.buttons.attr

要为按钮设置的属性键/值集合

按钮

buttons.buttons.available

确保在初始化按钮之前满足所有要求

按钮

buttons.buttons.className

设置按钮的类名

按钮

buttons.buttons.destroy

按钮销毁时调用的函数

按钮

buttons.buttons.enabled

设置按钮的初始启用状态

按钮

buttons.buttons.extend

定义按钮应该基于哪种按钮类型

按钮

buttons.buttons.init

初始化函数,可用于添加特定于此按钮的事件

按钮

buttons.buttons.key

为按钮定义激活键

按钮

buttons.buttons.name

为每个选择设置名称

按钮

buttons.buttons.namespace

每个按钮的唯一命名空间

按钮

buttons.buttons.split

拆分下拉按钮

按钮

buttons.buttons.tag

设置按钮的标签

按钮

buttons.buttons.text

按钮中显示的文本

按钮

buttons.buttons.titleAttr

按钮 title 属性文本

按钮

buttons.name

为组选择器实例设置名称

SearchBuilder

searchBuilder

启用并配置 DataTables 的 SearchBuilder 扩展

SearchBuilder

searchBuilder.columns

限制哪些列可以过滤

SearchBuilder

searchBuilder.conditions

为 SearchBuilder 定义自定义条件

SearchBuilder

searchBuilder.depthLimit

对组的深度施加限制

SearchBuilder

searchBuilder.enterSearch

在 Enter 键上触发搜索,而不是在每次按键上触发

SearchBuilder

searchBuilder.filterChanged

在进行选择时更新标题文本的函数。

SearchBuilder

searchBuilder.greyscale

从 SearchBuilder 中删除颜色

SearchBuilder

searchBuilder.liveSearch

控制实时搜索操作

SearchBuilder

searchBuilder.logic

设置默认逻辑运算符

SearchBuilder

searchBuilder.preDefined

设置预定义的搜索查询

SearchPanes

searchPanes

启用 Search Panes

SearchPanes

searchPanes.cascadePanes

允许窗格在选择下级联

SearchPanes

searchPanes.clear

禁用按钮以允许快速清除窗格中的选择

SearchPanes

searchPanes.collapse

允许 SearchPanes 折叠

SearchPanes

searchPanes.columns

选择在显示窗格时应考虑的列

SearchPanes

searchPanes.controls

隐藏控制按钮并禁用所有窗格中的搜索

SearchPanes

searchPanes.dtOpts

定义用作窗格的 DataTables 的属性

SearchPanes

searchPanes.emptyMessage

已弃用。设置自定义空消息

SearchPanes

searchPanes.filterChanged

在进行选择时更新标题文本的函数。

SearchPanes

searchPanes.hideCount

隐藏所有窗格中的计数列

SearchPanes

searchPanes.i18n

语言选项的容器

SearchPanes

searchPanes.i18n.clearMessage

设置要在清除按钮中显示的消息

SearchPanes

searchPanes.i18n.collapse

设置要在 SearchPanes 按钮中显示的消息

SearchPanes

searchPanes.i18n.collapseMessage

设置要在折叠按钮中显示的消息

SearchPanes

searchPanes.i18n.count

设置在未搜索时显示在计数列中的消息

SearchPanes

searchPanes.i18n.countFiltered

设置在搜索时显示在计数列中的消息

SearchPanes

searchPanes.i18n.emptyMessage

向显示为窗格选项的空消息添加国际化

SearchPanes

searchPanes.i18n.emptyPanes

向未显示任何窗格时显示的消息添加国际化

SearchPanes

searchPanes.i18n.loadMessage

向窗格正在加载时显示的消息添加国际化

SearchPanes

searchPanes.i18n.showMessage

设置要在显示按钮中显示的消息

SearchPanes

searchPanes.i18n.title

向显示选择多少个窗格的标题添加国际化

SearchPanes

searchPanes.initCollapsed

在初始化时折叠 SearchPanes

SearchPanes

searchPanes.layout

设置窗格在页面上显示方式的布局

SearchPanes

searchPanes.order

设置窗格的顺序

SearchPanes

searchPanes.orderable

隐藏所有窗格中的排序按钮

SearchPanes

searchPanes.panes

定义自定义窗格以过滤所有列

SearchPanes

searchPanes.panes.className

为自定义窗格添加自定义类

SearchPanes

searchPanes.panes.dtOpts

定义自定义窗格的 DataTables 选项

SearchPanes

searchPanes.panes.header

定义自定义窗格的标题

SearchPanes

searchPanes.panes.options

定义自定义窗格的选项

SearchPanes

searchPanes.panes.options.className

向自定义窗格的特定选项添加类

SearchPanes

searchPanes.panes.options.label

定义自定义窗格选项的标签

SearchPanes

searchPanes.panes.options.value

定义自定义窗格选项的值

SearchPanes

searchPanes.panes.preSelect

已弃用。为自定义窗格定义任何预选择

SearchPanes

searchPanes.preSelect

窗格中的预选选项

SearchPanes

searchPanes.threshold

设置列中显示其窗格所需的唯一值与总值的最小比率

SearchPanes

searchPanes.viewCount

在所有窗格中显示计数列

SearchPanes

searchPanes.viewTotal

在搜索时更新计数列以显示可见计数