columns().orderable()
自:DataTables 2.0 起
取得所選欄位是否可排序的狀態資訊。
描述
這個方法提供以程式方式檢查給定的欄位是否可由終端使用者排序(點擊標題儲存格),並可選擇性地取得欄位可採用的排序方向,如 columns.orderSequence
所定義。
類型
function columns().order( [ directions ] )
- 描述
取得所選欄位是否可排序的狀態資訊(已啟用或未啟用,以及可用的排序方向)。
- 參數
名稱 類型 選用 1 directions
是 - 預設值:false 控制傳回的資訊 - 詳細資訊請參閱下方說明。 可以不給定(undefined)、
false
或true
。- 傳回值
DataTables API 實例,針對每個選定的欄位包含
true
或false
,取決於排序狀態以及directions
是否為 undefined 或 false。如果傳入的參數為true
,則該方法將傳回有關欄位可採用的排序方向的資訊(請參閱columns.orderSequence
)。
範例
檢查第一個和第二個欄位是否可由終端使用者排序,如果可以,則對它們進行排序
var table = new DataTable('#myTable');
if (
table
.columns([0, 1])
.orderable()
.includes(true)
) {
table
.order([
[0, 'asc'],
[1, 'desc']
])
.draw();
}
相關
以下選項直接相關,在您的應用程式開發中也可能很有用。