{hero}

columns.orderData

自 DataTables 1.10 起

定義多個欄位的排序作為欄位的預設排序。

描述

允許欄位的排序使用來自不同(通常是隱藏的)欄位的資料作為排序資料,或是來自多個欄位的資料。

一個常見的例子是表格中包含相鄰的名和姓欄位,直觀上它們會被連結在一起進行多欄排序。另一個例子,使用單一欄位,是終端使用者看到的資料本身不可直接排序的情況(包含圖片的欄位),但存在一些可以排序的元數據(例如檔案名稱) - 請注意,正交資料是可用於此的替代方法。

這個參數的另一個常見用例是,當您希望在多個欄位上進行一致的資料排序時,第一欄中的資料可能具有相同的值。透過適當使用此參數,排序將會檢查所列出的第二欄的值並根據需要應用排序,以確保排序如預期般,無論先前的排序狀態如何。

類型

整數

描述

要排序的單一欄位索引

陣列

描述

定義多欄排序的多個欄位索引

預設

自動採用欄位的索引值

範例

使用 orderDatacolumnDefs 定義多欄排序

new DataTable('#myTable', {
	columnDefs: [
		{ orderData: [0, 1], targets: 0 },
		{ orderData: 0, targets: 1 },
		{ orderData: [2, 3, 4], targets: 2 }
	]
});

使用 orderDatacolumns 定義多欄排序

new DataTable('#myTable', {
	columns: [
		{ orderData: [0, 1] },
		{ orderData: 0 },
		{ orderData: [2, 3, 4] },
		null,
		null
	]
});

相關

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