{hero}

table()

自:DataTables 1.10

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

描述

DataTables API 可以同時對多個表格進行操作 - 這些表格位於「環境」中。舉一個簡單的例子,new DataTable('.dataTable').search('Fred').draw(); 將會篩選所有類別為 dataTable 的表格。

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

如果您在單一頁面上有多個表格,這種操作多個表格的能力會特別有用,但您也可能希望減少 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

相關

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