{hero}

table()

自 DataTables 1.10 版本起

根据 API 上下文中的选择器选择表格。

描述

DataTables API 可以同时操作多个表格 - “上下文”中的表格。举个简单的例子,new DataTable('.dataTable').search('Fred').draw(); 将过滤所有通过类 dataTable 找到的表格。

API 实例的上下文定义了 API 将操作哪些 DataTable 表格,此方法提供了一种控制该上下文中包含哪些表格的方式。

这种对多个表格进行操作的能力在您在一个页面上有多个表格时特别有用,但您可能也希望减少 API 上下文中的表格数量,以仅操作一个表格或表格的某个子集。

如果您只使用单表格 API 实例,则此方法对您来说用途有限!它实际上只适用于处理多个表格的情况。此外,请注意,此选择器无法执行超过 jQuery 直接在 DOM 上选择表格的操作。它主要为了方便和 API 的完整性而提供。

请注意,如果使用的选择器与 API 上下文中多个表格匹配,则返回的 API 实例的上下文将被截断为第一个匹配的表格。

类型

function table( selector )

描述

根据给定的选择器选择表格

参数
返回值

DataTables API 实例,其上下文中包含所选表格。

示例

对 API 上下文中的第二个表格应用排序

var tables = new DataTable('.dataTable');

tables
	.table(1)
	.order([3, 'asc'])
	.draw();

从 API 实例中查找带有 #admin 的表格,并对其应用全局搜索

var tables = new DataTable('.dataTable');

tables
	.table('#admin')
	.search('Important')
	.draw();

// Note that:
//   $('#admin').DataTable().search('Important').draw();
// would also have achieved the same effect

相关

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