DataTable.isDataTable()
自 DataTables 1.11 起
檢查表格節點是否為 DataTable。
說明
此方法提供檢查 table
節點是否已經是 DataTable 的能力。這對於確保您不會重新初始化已經是 DataTable 的表格非常有用。
請注意,這是一個靜態函數,透過 DataTable
或 $.fn.dataTable
物件存取,而不是 API 實例。它可以在任何時候存取,甚至在頁面上建立任何 DataTables 之前。
在 DataTables 1.11 之前,此方法只能透過 $.fn.dataTable
物件存取。從 1.11 開始,可以使用 DataTable
或 $.fn.dataTable
。
類型
function isDataTable( table )
- 說明
檢查
table
節點是否已經是 DataTable 表格。- 參數
名稱 類型 選填 1 table
否 要檢查的表格。 可以給定為下列之一
- DOM 元素
- jQuery 選擇器
- 包含要檢查節點的 jQuery 物件
- DataTables API 實例。
請注意,如果 jQuery 選擇器或物件匹配多個節點,則只會檢查第一個節點。
- 回傳值
如果給定的表格是 DataTable,則回傳
true
,否則回傳false
範例
非 jQuery:檢查 #example
是否為 DataTable。 如果不是,則初始化
if (!DataTable.isDataTable('#example')) {
new DataTable('#example');
}
jQuery:檢查 #example
是否為 DataTable。 如果不是,則初始化
if (!$.fn.DataTable.isDataTable('#example')) {
new DataTable('#myTable');
}