DataTable.tables()
起始版本:DataTables 1.11
取得頁面上所有的 DataTables。
描述
能夠取得頁面上現有的 DataTables 清單非常實用,特別是在表格啟用捲軸並且需要在可見時調整其欄寬的情況下。此方法提供了這種能力。
請注意,這是一個靜態函數,是透過 DataTable
或 $.fn.dataTable
物件存取的,而不是 API 實例。它可以在任何時間存取,即使在頁面上建立任何 DataTables 之前。
在 DataTables 1.11 之前,此方法只能透過 $.fn.dataTable
物件存取。從 1.11 開始,可以使用 DataTable
或 $.fn.dataTable
。
類型
function tables( [ visible ] )
- 描述
取得所有已初始化的 DataTable 表格 - 可選擇僅取得目前可見的表格和/或將表格作為 API 實例檢索。
- 參數
名稱 類型 選用 1 visible
是 - 預設值:false 作為布林值,此選項用於指示您想要返回頁面上所有表格(
false
),還是僅返回可見表格(true
)。自 1.10.8 起,此選項也可以作為具有以下可選參數的物件給出
boolean
visible
- 僅取得可見表格 (true
) 或取得所有表格,無論是否可見 (false
)。boolean
api
- 返回選定表格的DataTables.Api
實例或array
- 返回值
包含所有匹配 DataTables 的 DataTable API 實例
範例
非 jQuery:調整所有可見表格的欄寬
DataTable.tables({ visible: true, api: true }).columns.adjust();
調整所有可見表格的欄寬
$.fn.dataTable.tables({ visible: true, api: true }).columns.adjust();
當表格在 Bootstrap 索引標籤中設為可見時,調整欄寬
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
$.fn.dataTable.tables({ visible: true, api: true }).columns.adjust();
});