tables()
自:DataTables 1.10 起
根據 API 環境中的選擇器選擇表格。
描述
DataTables API 可以一次操作多個表格 - 即「環境」中的表格。舉一個簡單的例子,new DataTable('.dataTable').search('Fred').draw();
將會篩選出所有被類別 dataTable
找到的表格。
API 實例的環境定義了 API 將操作的 DataTables 表格,而此方法提供了一種控制環境中表格的方式。
如果您在單一頁面上有多個表格時,這種操作多個表格的能力會特別有用,但您可能也希望縮減 API 環境中的表格,只操作其中一個,或是一部分的表格。
如果您只使用單一表格 API 實例,那麼此方法對您來說用途有限!它主要適用於操作多個表格的情況。此外,請注意,此選擇器無法執行任何 jQuery 直接在 DOM 上選擇表格的功能。它主要是為了方便和 API 的完整性而提供的。
類型
function tables( selector )
- 描述
根據給定的選擇器選擇表格
- 參數
名稱 類型 可選 1 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
相關
以下選項直接相關,在您的應用程式開發中也可能很有用。