{hero}

includes()

自:DataTables 2.0 起

判斷 API 結果集中是否包含給定的值。

描述

您可能會發現知道 API 實例的結果集中是否包含特定值很有用。雖然可以使用 indexOf() 輕鬆實現這一點,但如果您不需要知道該值在結果集中的位置,此實用方法可以作為一個有用的捷徑。

此方法利用 DataTables API 物件是「類似陣列」的事實,它們繼承了 Javascript Array 類型的大部分能力和方法。

類型

function includes( value )

描述

判斷結果集中是否包含給定的值。

參數
回傳值

如果找到則為 true,否則為 false

範例

檢查目前頁面上是否可見某個值

var table = new DataTable('#myTable');

var found = table
	.column(0, { page: 'current' })
	.data()
	.includes(21);

if (found) {
	alert('21 was not found in the result set');
}
else {
	alert('21 was found at index: ' + index);
}

相關

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