colReorder.order()
自:ColReorder 1.2.0 起
取得 / 設定欄位順序。
請注意 - 此屬性需要 DataTables 的 ColReorder 擴充功能。
說明
此方法提供取得 DataTable 目前欄位順序以及設定新順序的功能。
此方法觸發的重新排序是立即性的,不需要重新繪製表格。
類型
function colReorder.order( order [, originalIndexes ] )
- 說明
設定欄位順序。
- 參數
名稱 類型 選用 1 order
否 欄位索引的陣列,定義重新排序後欄位應放置的位置。
請注意,預設情況下,此陣列給定的欄位索引會被假定為目前的欄位索引,亦即,無論表格的排序方式為何,
0
永遠會指向表格中的第一個欄位。選用的第二個參數可以用來指示應將其視為原始索引。2 originalIndexes
是 - 預設值:false 自 1.3.0 起:順序陣列透過欄位索引定義欄位應顯示的位置,但這些索引可以是以下其中之一
- 目前的欄位索引(亦即,即使欄位重新排序已經發生)
- 原始的欄位索引(亦即,在 ColReorder 執行任何重新排序之前,欄位的原始索引)
設定為
true
表示傳入的索引為原始索引。false
或undefined
(預設值)會將其視為目前的索引。- 回傳值
用於鏈接的 DataTables API 實例
範例
在按鈕點擊時反轉表格中的欄位順序
var table = new DataTable('#myTable', {
colReorder: true
});
$('#reverse').click(function (e) {
table.colReorder.order([5, 4, 3, 2, 1, 0]);
});
還原原始順序,無論已套用任何排序(透過將第二個參數傳遞為 true
)
var table = new DataTable('#myTable', {
colReorder: true
});
$('#reverse').click(function (e) {
table.colReorder.order([0, 1, 2, 3, 4, 5], true);
});