eq()
自:DataTables 1.10
将 Api 实例简化为单一上下文和结果集。
描述
DataTables API 旨在通过单个 API 实例处理多张表(上下文),这通常很有用,但有时您只想处理一张表,并从简化的复杂度中受益(标量而不是矢量)。
API 的选择器方法将以 2D 数组格式提供其结果集,外部数组用于识别上下文中的每张表,而内部数组包含该表从选择器获得的结果。如果需要,您可以轻松地在每张表中循环,但如果您仅使用一张表,则可以使用此方法将 API 实例简化为有问题的表。
作为一个说明性示例,rows()
方法将返回上面描述的 2D 数组格式,其中内部数组数据包含所选的行索引。对于单个表的简单操作,我们只需要一个包含所选行索引的 1D 数组,并将 API 实例的上下文设置为有问题的表。这正是 eq()
方法提供的能力。
请注意,最初此方法可能看起来类似于 get()
方法,但这两个方法提供了略微不同的功能
类型
函数 eq( idx )
- 描述
根据给定的索引,将 API 实例简化为单个上下文和结果集。这有助于简化与 API 的一些交互。
- 参数
名称 类型 可选 1 idx
否 要选择的索引
- 返回
新的 DataTables API 实例,其上下文和结果集包含指定索引的表和数据。如果没有匹配的上下文,则将返回一个空 API 实例。
示例
根据条件表达式向行添加一个类
var table = new DataTable('#myTable');
table
.rows()
.eq(0)
.each(function (idx) {
var row = table.row(idx);
if (row.data().grade === 'A') {
row
.node()
.to$()
.addClass('gradeA');
}
});
显示表中所有行的子行
var table = new DataTable('#myTable');
table
.rows()
.eq(0)
.each(function (idx) {
table.row(idx).child.show();
});
相关
以下选项直接相关,也可能对您的应用程序开发有用。