columns().order()
自 DataTables 1.10 起:
依選取的欄位排序表格。
說明
此方法提供一個有用的替代方案,可以取代 order()
方法,讓您可以使用彈性的 columns()
選擇器來選擇您想要排序的欄位,並依照指定的方向排序。從 v2 開始,它也可以讓您取得關於選取欄位的排序資訊 - 判斷這些欄位是否用於表格的目前排序以及排序方向。
多欄位排序是透過確保欄位選擇器符合多個欄位來實現(如果只符合一個欄位,則執行單欄位排序,或者使用 column().order()
方法)。符合的欄位的順序定義了表格排序應用的優先順序。
請注意,當作為設定器使用時,此方法會設定要套用到表格的排序 - 它實際上不會執行排序。若要執行排序,請使用 draw()
方法,可以直接作為 order()
方法的返回物件的鏈式方法呼叫 - 例如 table.order([0, 'desc']).draw();
。
類型
function columns().order()
- 說明
判斷表格是否正在依選取的欄位排序。
- 傳回
包含
asc
、desc
或空字串(表示索引資料順序)的 DataTables API 實例,用於套用到每個選取欄位的可能排序。如果未對選取的欄位進行排序,則會給予null
。
範例
依類別為 '.status' 的所有欄位排序
var table = new DataTable('#myTable');
table
.columns('.status')
.order('desc')
.draw();
相關
以下選項直接相關,在您的應用程式開發中也可能很有用。