初始化
自:DataTables 1.10
初始化完成事件 - 在 DataTables 完全初始化并加载数据时触发。
说明
init
事件是 initComplete
初始化选项的事件补充。与回调一样,当您的表格完全初始化、数据已加载并绘制完成后,将会调用 init
事件,这在使用 ajax
数据源时尤其有用。在此类情况下,表格将在数据加载之前完成其初始运行(毕竟,Ajax 是异步的!)因此提供此回调以让您知道数据是否已完全加载。
init
事件是在与 initComplete
相同的时间点触发的(从技术上来说,回调在事件之前触发,但它们是按顺序发生的,因此两者都可以用于实现相同的效果)。
请注意,与所有 DataTables 发出的事件一样,事件对象在其上具有可用的 DataTables API 实例(第一个参数)。此外,事件会使用 dt
命名空间触发。因此,要侦听此事件,您还必须使用 dt
命名空间,只需将 .dt
附加到您的事件名称上,如下面的示例中所示。
此事件会冒泡到文档中,因此您可以将 init.dt
侦听器添加到 body
中,以捕获 DataTables 触发的所有初始化事件。
类型
function function( e, settings, json )
- 参数
名称 类型 可选 1 e
否 jQuery 事件对象
2 settings
否 DataTables 设置对象
3 json
否 从服务器检索的 JSON 数据(如果 Ajax 加载数据)
示例
使用 API 显示有关当前排序的信息
console.log('Table initialisation start: ' + new Date().getTime());
$('#example')
.on('init.dt', function () {
console.log('Table initialisation complete: ' + new Date().getTime());
})
.DataTable();
相关信息
以下选项与之直接相关,在您的应用程序开发中也可能非常有用。