{hero}

tables()

自:DataTables 1.10 起

根據 API 環境中的選擇器選擇表格。

描述

DataTables API 可以一次操作多個表格 - 即「環境」中的表格。舉一個簡單的例子,new DataTable('.dataTable').search('Fred').draw(); 將會篩選出所有被類別 dataTable 找到的表格。

API 實例的環境定義了 API 將操作的 DataTables 表格,而此方法提供了一種控制環境中表格的方式。

如果您在單一頁面上有多個表格時,這種操作多個表格的能力會特別有用,但您可能也希望縮減 API 環境中的表格,只操作其中一個,或是一部分的表格。

如果您只使用單一表格 API 實例,那麼此方法對您來說用途有限!它主要適用於操作多個表格的情況。此外,請注意,此選擇器無法執行任何 jQuery 直接在 DOM 上選擇表格的功能。它主要是為了方便和 API 的完整性而提供的。

類型

function tables()

描述

選擇所有表格

返回

DataTables API 實例,其中包含目前環境中的所有表格。

function tables( selector )

描述

根據給定的選擇器選擇表格

參數
返回

DataTables API 實例,其環境中包含選定的表格。

範例

對 API 環境中的第二個和第三個表格套用排序

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

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

從 API 實例中找到所有具有 admin 類別的表格,並對它們套用全域搜尋

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

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

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

相關

以下選項直接相關,在您的應用程式開發中也可能很有用。