{hero}

columns().order()

自 DataTables 1.10 起:

依選取的欄位排序表格。

說明

此方法提供一個有用的替代方案,可以取代 order() 方法,讓您可以使用彈性的 columns() 選擇器來選擇您想要排序的欄位,並依照指定的方向排序。從 v2 開始,它也可以讓您取得關於選取欄位的排序資訊 - 判斷這些欄位是否用於表格的目前排序以及排序方向。

多欄位排序是透過確保欄位選擇器符合多個欄位來實現(如果只符合一個欄位,則執行單欄位排序,或者使用 column().order() 方法)。符合的欄位的順序定義了表格排序應用的優先順序。

請注意,當作為設定器使用時,此方法會設定要套用到表格的排序 - 它實際上不會執行排序。若要執行排序,請使用 draw() 方法,可以直接作為 order() 方法的返回物件的鏈式方法呼叫 - 例如 table.order([0, 'desc']).draw();

類型

function columns().order()

說明

判斷表格是否正在依選取的欄位排序。

傳回

包含 ascdesc 或空字串(表示索引資料順序)的 DataTables API 實例,用於套用到每個選取欄位的可能排序。如果未對選取的欄位進行排序,則會給予 null

function columns().order( direction )

說明

columns() 選擇器選取的欄位,以指定方向排序表格。

參數
傳回

DataTables API 實例

範例

依類別為 '.status' 的所有欄位排序

var table = new DataTable('#myTable');

table
	.columns('.status')
	.order('desc')
	.draw();

相關

以下選項直接相關,在您的應用程式開發中也可能很有用。