splice()

自：DataTables 1.10 起

修改 Api 實例結果集中的內容，根據需要從中新增或移除項目。

描述

pop()、shift() 等方法對於修改 Api 實例的結果集非常有用，但它們僅限於在結果集的開始或結束處操作。此方法可用於在任何點修改結果集。

此方法利用了 DataTables API 物件是「類陣列」的事實，因為它們繼承了 JavaScript Array 類型的許多能力和方法。

在這種情況下，此方法是 JavaScript Array.prototype.splice 方法的代理，並作為 DataTables API 的實用方法提供。有關原始方法的更多資訊，請參閱 Mozilla MDN 文件中關於 splice 的說明。

類型

function splice( index, howMany [, value_1 [, ... ] ] )

描述

修改 Api 實例結果集中的內容，根據需要從中新增或移除項目。

參數

	名稱	類型	可選
1	`index`	`整數`	否
	開始修改 Api 實例結果集的索引。
2	`howMany`	`整數`	否
	要從結果集中移除的元素數量。如果您只想新增新項目，則可以為 0。
3	`value_1`	`任意`	是
	要新增到由第一個參數指定的索引處的結果集的項目。可以通過將多個項目作為其他參數新增，在單個呼叫中新增多個項目。

回傳

陣列

已移除項目的陣列。如果沒有移除任何元素，則會返回一個空陣列。

範例

使用 indexOf() 搜尋值，如果找到，則使用 splice() 替換它。

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

// Get column data
var data = table.column(0).data();

// Find the first instance of `32`
var idx = data.indexOf(32);

// Replace with `33`
if (idx >= 0) {
	data.splice(idx, 1, 33);
}