ready()
自:DataTables 2.0
确定 DataTable 是否就绪。
说明
有时你可能想知道 DataTables 是否处于“就绪”状态 - 例如,它已经初始化,其控制元素在页面上,并且第一个数据已经加载并显示。开始处理数据可能很有用。DataTables 有一个 init
事件和一个 initComplete
选项,可以用来实现此目的,但它们仅在一个表上触发一次并且(如果没有此方法)没有办法了解该表是否已就绪。
此方法可以用两种不同的方式;首先确定 DataTable 的就绪状态,其次在表就绪时执行一个函数,或者如果表已经就绪则立即执行。
类型
函数 ready( fn )
- 说明
在表就绪时或在已就绪的情况下立即执行函数。
- 参数
名称 类型 可选 1 fn
否 要执行的函数。范围设置为针对 DataTable 的 API 实例。不传入任何参数,也不期望任何返回值。
- 返回
API 实例,用于链接。
实例
为加载 DOM 的表执行一个函数 - 由于表初始化是同步的,因此将立即执行。
let table = new DataTable('#myTable');
table.ready(function () {
// Actions to take when the table is ready
// ...
});
为加载 Ajax 的表执行一个函数 - 这将在加载数据后执行,而加载数据是异步的。
let table = new DataTable('#myTable', {
ajax: '/api/data'
});
table.ready(function () {
// Actions to take when the table is ready
// ...
});
相关
以下选项直接相关,并且在你的应用程序开发中也可能十分有用。