rows.add()

自：DataTables 1.10 起

在表格中加入多個新列。

描述

將新資料加入表格是能夠動態控制 DataTable 內容的核心概念，而此方法則提供了一次加入多個新列的功能。如果您只想一次加入單一列，則可以使用此方法的單數對應方法 row.add()。

所加入的列會受到套用至表格的排序和搜尋條件的影響，這將決定新列在表格中的位置和可見性。

此方法會在內部將資料加入表格，但不會視覺更新表格的顯示以反映此新資料。為了更新表格的顯示，請使用 draw() 方法，可以簡單地將其作為 row.add() 方法傳回物件的鏈式方法來呼叫 - 例如 table.row.add( [ 1, 2, 3, 4 ] ).draw();。這樣做是為了方便優化表格，以便在重新繪製表格之前可以加入多個列。

類型

function rows.add( data )

描述

使用給定的資料在表格中加入新列

參數

	名稱	類型	可選
1	`data`	`陣列`	否
	資料元素的陣列，其中每個元素描述要加入表格的新列 (即 `data.length` 是將加入表格的新列數量)。每個資料元素可以是陣列、物件、JavaScript 物件實例或 `tr` 元素。給定的資料結構必須與表格中其他資料的格式相同 (即，如果您的表格使用物件，請在此處傳入物件！)。

回傳

DataTables.Api

DataTables API 實例，其中包含結果集中新加入的列。

範例

在表格中加入兩個新列並重新繪製

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

table.rows
	.add([
		{
			name: 'Tiger Nixon',
			position: 'System Architect',
			salary: '$3,120',
			start_date: '2011/04/25',
			office: 'Edinburgh',
			extn: '5421'
		},
		{
			name: 'Garrett Winters',
			position: 'Director',
			salary: '$5,300',
			start_date: '2011/07/25',
			office: 'Edinburgh',
			extn: '8422'
		}
	])
	.draw();

將物件的多個新實例加入表格，然後將類別加入這些新加入的列

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

table.rows
	.add([new Pupil(43), new Pupil(67), new Pupil(102)])
	.draw()
	.nodes()
	.to$()
	.addClass('new');

rows.add()

描述

類型

function rows.add( data )

範例

相關

DataTables