排序
自:DataTables 1.10 起
order 事件 - 當表格中包含的資料排序時觸發。
描述
當表格中的資料排序時,會觸發 order
事件。這通常由終端使用者排序欄位觸發,但也可能透過 order()
方法或在完整重新繪製(呼叫 draw()
)時啟動。
請注意,order
會在表格使用更新的資料重新繪製之前觸發,儘管資料會在內部排序。
請注意,如同所有 DataTables 發出的事件,事件物件上會有一個 DataTables API 實例(第一個參數)。此外,事件會使用 dt
命名空間觸發。因此,要監聽此事件,您也必須使用 dt
命名空間,只需將 .dt
附加到您的事件名稱即可,如下例所示。
類型
function function( e, settings, ordArr )
- 參數
名稱 類型 選填 1 e
否 jQuery 事件物件
2 settings
否 DataTables 設定物件
3 ordArr
否 描述目前套用排序的物件陣列
範例
使用 API 顯示目前排序的相關資訊
var table = new DataTable('#myTable');
table.on('order', function () {
// This will show: "Ordering on column 1 (asc)", for example
var order = table.order();
$('#orderInfo').html(
'Ordering on column ' + order[0][0] + ' (' + order[0][1] + ')'
);
});
相關
以下選項直接相關,在您的應用程式開發中也可能有用。