unshift()
自:DataTables 1.10
添加一个或多个项目到 API 实例结果集的开头。
说明
正如 JavaScript 数组一样,由于 DataTables API 对象为“类数组”,因此可以使用此方法向结果集添加项目。将项目“unshift”到 API 实例中将它添加到结果集的开头。如果需要,可以使用 push()
在结果集的末尾添加项目。
此方法是 Javascript Array.prototype.unshift
方法的代理,并作为 DataTables API 的实用方法提供。有关原始方法的更多信息,请参考 unsift
的 Mozilla MDN 文档。
类型
函数 unshift( value_1 [, value_2 [, ...] ] )
- 说明
添加一个或多个项目到 API 实例结果集的开头。
- 参数
名称 类型 可选 1 value_1
任何
否 要添加到 API 实例结果集中的项目。
2 value_2
任何
是 要添加到 API 实例结果集中的其他项目。使用尽可能多的参数添加其他项目。
- 返回值
已修改的 API 实例的长度
示例
向从列数据返回的数组中添加空字符串(例如,可用于构建搜索列表)
var table = new DataTable('#myTable');
var data = table.column(0).data();
data.unshift('');