splice()

自：DataTables 1.10

修改 Api 实例结果集的内容，根据需要添加或移除项目。

说明

pop()、shift() 的方法对于修改 Api 实例的结果集很有用，但它们局限于在结果集的开头或结尾操作。此方法可用于修改结果集中的任何点。

此方法利用了 DataTables API 对象“类数组”的事实，它们继承了很多 Javascript Array 类型的功能和方法。

在这种情况下，此方法是 Javascript Array.prototype.splice 方法的代理，并作为 DataTables API 的实用方法提供。有关原始方法的更多信息，请参阅 splice 的 Mozilla MDN 文档。

类型

函数 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);
}