{hero}

ready()

自:DataTables 2.0

确定 DataTable 是否就绪。

说明

有时你可能想知道 DataTables 是否处于“就绪”状态 - 例如,它已经初始化,其控制元素在页面上,并且第一个数据已经加载并显示。开始处理数据可能很有用。DataTables 有一个 init 事件和一个 initComplete 选项,可以用来实现此目的,但它们仅在一个表上触发一次并且(如果没有此方法)没有办法了解该表是否已就绪。

此方法可以用两种不同的方式;首先确定 DataTable 的就绪状态,其次在表就绪时执行一个函数,或者如果表已经就绪则立即执行。

类型

函数 ready()

说明

确定表的就绪状态。请注意,如果你的 API 实例包含多个表的内容,则将仅返回第一个表的状态。

返回

如果表就绪,则为 true,否则为 false

函数 ready( fn )

说明

在表就绪时或在已就绪的情况下立即执行函数。

参数
返回

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
	// ...
});

相关

以下选项直接相关,并且在你的应用程序开发中也可能十分有用。