sort()
自 DataTables 1.10 起
排序 API 實例結果集中的元素。
說明
sort()
方法提供了一種排序 API 實例結果集中數據的方式,如果您想將這些數據顯示給終端使用者,例如作為搜尋輸入的 select
列表,這將特別有用。此方法不應與 order()
混淆,後者用於排序 DataTable 中的記錄。
此方法利用了 DataTables API 物件是「類似陣列」的事實,因為它們繼承了許多 Javascript Array
類型的能力和方法。
在這種情況下,此方法是 Javascript Array.prototype.sort
方法的代理,並作為 DataTables API 的實用方法提供。 有關原始方法的更多資訊,請參閱 Mozilla MDN 關於 sort
的文件。
類型
function sort( [ fn ] )
- 說明
排序 API 實例結果集中的元素。
- 參數
名稱 類型 可選 1 fn
是 - 預設值 這是一個標準的 Javascript 排序比較函數。它接受兩個參數
- 要比較的值 1
- 要比較的值 2
並期望傳回一個值,指示兩個值的排序位置。小於 0 表示第一個值在第二個值之前,大於 0 表示第一個值在第二個值之後,傳回 0 表示它們相同。
- 傳回
原始 API 實例,其結果集已按照所使用的排序條件定義進行排序。
範例
排序來自欄位的數據
var table = new DataTable('#myTable');
var data = table
.column(0)
.data()
.sort();