{hero}

order.fixed()

自:DataTables 1.10.10 起

取得/設定套用至表格的固定排序。

描述

此方法提供控制套用至 DataTable 的固定排序的能力。「固定」排序是一種欄排序,它會在套用使用者排序之前和/或之後套用至表格的排序。例如,考慮一個您希望始終按第 0 欄排序的表格,此方法(或 orderFixed)可用於套用該固定排序,而終端使用者隨後可以藉由 DataTables 的多欄排序將自己的排序新增至表格。

固定排序可以在使用者自己的排序條件之前 (pre) 或之後 (post) 套用,方法是使用此方法的值中可以給出的兩個不同屬性,當用作設定器時。

用於描述表格排序條件的值以兩個元素的陣列形式給出

  • 要排序的欄索引
  • 要套用的排序方向(asc 代表升序,或 desc 代表降序)。

也可以給出一組巢狀陣列(即陣列中的陣列)以允許指派多欄排序。

類型

function order.fixed()

描述

取得套用至表格的固定排序。如果 API 的上下文中有多個表格,則只會傳回第一個表格的排序(如果需要 API 上下文中不同表格的排序,請使用 table())。

傳回

傳回的物件可能具有兩個屬性

  • pre - 在使用者自己的排序之前套用的排序
  • post - 在使用者自己的排序之後套用的排序

每個屬性都可能未定義,在這種情況下,不會從該屬性套用排序。

function order.fixed( order )

描述

設定表格的固定排序。請注意,這實際上並不會執行排序,而是會將其排入佇列 - 請使用 draw() 執行排序。

參數
傳回

DataTables API 實例

範例

設定表格的固定排序

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

table.order.fixed({
	pre: [0, 'asc']
});

相關

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