事件

DataTables 及其扩展在执行特定操作时会发出自定义 DOM 事件,提供监听这些事件并在事件发生时采取行动的功能,例如,在表格重新绘制时更新有关表格的显示信息。

所有 DataTables 发出的事件都可以使用 on() 方法或 jQuery.on() 方法(带 dt 命名空间)来监听(所有事件都使用 dt 命名空间触发,以确保它们不会与其他库中的自定义事件冲突!)。以下示例显示了如何监听 draw 事件

$('#myTable').on( 'draw.dt', function () {
    alert( 'Table redrawn' );
} );

有关 DataTables 自定义事件的进一步一般信息,请参阅 事件手册

名称 摘要
DataTables

childRow

已向表格添加或从表格中删除子行

DataTables

column-sizing

列调整大小事件 - 在列宽重新计算时触发。

DataTables

column-visibility

列可见性事件 - 在列的可见性发生变化时触发。

DataTables

destroy

表格销毁事件 - 在表格被销毁时触发。

DataTables

draw

绘制事件 - 在表格完成绘制后触发一次。

DataTables

dt-error

错误事件 - 在 DataTables 处理数据期间发生错误。

DataTables

info

更新表格信息显示。

DataTables

init

初始化完成事件 - 在 DataTables 完全初始化和数据加载后触发。

DataTables

length

页面长度更改事件 - 在页面长度发生改变时触发。

DataTables

options

初始化 DataTable - 传递选项。

DataTables

order

order 事件 - 在对表格中包含的数据进行排序时触发。

DataTables

page

页面更改事件 - 在表格的分页更新时触发。

DataTables

preDraw

预绘制事件 - 在表格即将重新绘制时触发。

DataTables

preInit

初始化已启动事件 - 在数据加载之前立即触发。

DataTables

preXhr

Ajax 事件 - 在发出 Ajax 请求之前触发

DataTables

processing

处理事件 - 在 DataTables 处理数据时触发

DataTables

requestChild

DataTables 想要显示子行

DataTables

search

搜索事件 - 在表格被筛选时触发。

DataTables

stateLoadParams

状态加载事件 - 在从存储中加载状态时触发。

DataTables

stateLoaded

状态已加载事件 - 在状态已加载并应用后触发一次。

DataTables

stateSaveParams

状态保存事件 - 在保存表格状态信息时触发。

DataTables

xhr

Ajax 事件 - 在 Ajax 请求完成后触发

AutoFill

autoFill

已完成自动填充操作

AutoFill

preAutoFill

即将对表格应用自动填充操作

按钮

buttons-action

已触发按钮的动作方法

按钮

buttons-processing

已更改按钮的处理状态

ColReorder

column-reorder

列已通过最终用户或 API 重新排序

ColReorder

columns-reordered

列重新排序已完成,表格已更新

KeyTable

key

在表格上检测到一个键事件,并且它由 KeyTable 处理

KeyTable

key-blur

KeyTable 已从单元格模糊焦点

KeyTable

key-focus

KeyTable 已聚焦到一个单元格

KeyTable

key-prefocus

KeyTable

key-refocus

KeyTable 已重新聚焦到一个单元格

KeyTable

key-return-submit

Return 键用于提交编辑器内联编辑

响应式

responsive-display

行详细信息已显示、更新或隐藏

响应式

responsive-resize

由于调整大小,Responsive 显示的列已更改

RowGroup

rowgroup-datasrc

已更改分组数据属性

RowReorder

pre-row-reorder

最终用户已启动行重新排序操作。

RowReorder

row-reorder

最终用户已重新排序行

RowReorder

row-reorder-canceled

最终用户取消了重新排序

RowReorder

row-reorder-changed

最终用户已将行移至新位置

RowReorder

row-reordered

最终用户重新排序行后

SearchBuilder

dtsb-inserted

来自 init 函数的元素已插入 DOM

选择

deselect

项目(行、列或单元格)已取消选择

选择

select

项目(行、列或单元格)已选择

选择

select-blur

在数据表中模糊项选择之前(可取消)

选择

selectItems

选择项目类型更改事件。

选择

selectStyle

选择样式更改事件。

选择

user-select

用户操作将导致表中选择项目

StateRestore

stateRestore-change

在 StateRestore 中添加、删除或更改状态时触发