{hero}

eq()

自:DataTables 1.10

将 Api 实例简化为单一上下文和结果集。

描述

DataTables API 旨在通过单个 API 实例处理多张表(上下文),这通常很有用,但有时您只想处理一张表,并从简化的复杂度中受益(标量而不是矢量)。

API 的选择器方法将以 2D 数组格式提供其结果集,外部数组用于识别上下文中的每张表,而内部数组包含该表从选择器获得的结果。如果需要,您可以轻松地在每张表中循环,但如果您仅使用一张表,则可以使用此方法将 API 实例简化为有问题的表。

作为一个说明性示例,rows() 方法将返回上面描述的 2D 数组格式,其中内部数组数据包含所选的行索引。对于单个表的简单操作,我们只需要一个包含所选行索引的 1D 数组,并将 API 实例的上下文设置为有问题的表。这正是 eq() 方法提供的能力。

请注意,最初此方法可能看起来类似于 get() 方法,但这两个方法提供了略微不同的功能

  • eq() 从引用多张表的 API 实例中选择一张特定的 DataTable
  • get() 从 API 实例获取数据。

类型

函数 eq( idx )

描述

根据给定的索引,将 API 实例简化为单个上下文和结果集。这有助于简化与 API 的一些交互。

参数
返回

新的 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();
	});

相关

以下选项直接相关,也可能对您的应用程序开发有用。