unshift()
自：DataTables 1.10
將一或多個項目新增至 API 實例結果集的開頭。
說明
如同 Javascript 陣列一樣，由於 DataTables API 物件是「類陣列」，因此可以使用此方法將項目新增至結果集。將項目unshift到 API 實例上會將其新增至結果集的開頭。如果需要，可以使用 push() 將項目新增至結果集的末尾。
此方法是 Javascript Array.prototype.unshift 方法的代理，並作為 DataTables API 的實用方法提供。有關原始方法的更多資訊，請參閱 Mozilla MDN 中有關 unshift 的文件。
類型
function 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('');