columns-reordered
自:ColReorder 2.0 起
欄位重新排序已完成,表格已更新。
請注意 - 此屬性需要 DataTables 的 ColReorder 擴充功能。
描述
此事件讓您知道欄位重新排序何時完成。這可能發生在個別呼叫 colReorder.move()
(用於 UI 拖放重新排序)之後,或在呼叫 colReorder.order()
所需的所有更新之後。
您也可以使用 column-reorder
事件來知道何時發生重新排序 - 它會在每次重新排序動作時發生(也就是說,它可能會從 colReorder.order()
觸發多次)。
請注意,與所有 DataTables 發出的事件一樣,此事件會使用 dt
命名空間觸發。因此,若要監聽此事件,您也必須使用 dt
命名空間,只需將 .dt
附加到您的事件名稱,或使用 on()
方法來監聽事件,這將會自動附加此命名空間。
類型
function function( e, details )
- 參數
名稱 類型 可選 1 e
否 jQuery 事件物件
2 details
否 一個包含有關重新排序欄位資訊的物件
array
order
- 目前欄位順序 (colReorder.order()
)array
mapping
- 定義舊欄位位置如何對應到新位置的整數陣列
範例
欄位重新排序完成時的通知
var table = new DataTable('#myTable', {
colReorder: true
});
table.on('columns-reordered', function (e, settings, details) {
console.log('Columns have been reordered');
});