rows()

自：DataTables 1.10 起

從表格中選取多個列。

描述

處理列是 DataTables 的基本部分，您需要能夠輕鬆地從表格中選取想要的列。此方法是列的對應方法，對應於 columns() 和 cells() 方法，分別用於處理表格中的欄和儲存格。使用選取器和 selector-modifier 選項，可以使用此方法本身的鏈式方法來取得表格中的列，這些方法提供了從列中取得資料、列節點以及使資料失效的能力，以及其他操作。

雖然此 rows() 方法透過單次呼叫提供對多列的存取，但其單數對應方法 row() 用於一次選取和操作單列，允許更精細的增益控制和單數方法中提供的其他方法，例如更新資料和處理子列。

此方法有兩種形式，反映了可以根據您的實作需求以多種不同方式選取列的事實

所有列 (沒有參數，或僅有 selector-modifier 選項)
列選取器

類型

function rows( [ modifier ] )

描述

選取所有列

參數

傳回

	名稱	類型	選用
1	`modifier`	`selector-modifier`	是 - 預設值
	用於指定列的排序方式的選項，以及是否應將表格中的分頁或搜尋選項納入考量。

DataTables.Api

具有選取列的 DataTables API 實例

function rows( rowSelector [, modifier ] )

描述

選取由列選取器找到的列

參數

	名稱	類型	選用
1	`rowSelector`	`row-selector`	否
	列選取器。
2	`modifier`	`selector-modifier`	是 - 預設值
	用於指定列的排序方式的選項，以及是否應將表格中的分頁或搜尋選項納入考量。

傳回

DataTables.Api

具有結果集中選取列的 DataTables API 實例

範例

選取所有列

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

let allRows = table.rows();

選取具有指定 id 的列

let rows = table.rows('#myId');

選取具有特定類別的所有列

let rows = table.rows('.myClass');

選取具有指定索引的列

let rows = table.rows([0, 1]);

使用函式選取具有比對資料的列

let rows = table.rows((idx, data) => data.location === 'Edinburgh');

使用選取器修飾符選取搜尋集中所有列

let rows = table.rows({
	search: 'applied'
});

rows()

描述

類型

function rows( [ modifier ] )

function rows( rowSelector [, modifier ] )

範例

相關

DataTables