rows.add()

自：DataTables 1.10

向表格中添加多行新行。

简介

向表格中添加新数据是动态控制 DataTable 内容概念的核心，而此方法恰好提供了执行此操作的能力，即一次添加多行新行。如果您希望一次只添加一行，可以使用此方法的单数对应方法 row.add()。

添加的行会受到应用于该表格的排序和搜索条件的约束，这将决定新行在该表格中的位置和可见性。

此方法将在内部将数据添加到表格中，但不会从视觉上更新表格显示以考虑此新数据。为了更新表格的显示，可以使用 draw() 方法，可将其作为一个链式方法调用 row.add() 方法返回的对象，例如 table.row.add( [ 1, 2, 3, 4 ] ).draw();。这样做是为了简化表格的优化，可以在重新绘制表格之前添加多行。

类型

函数 rows.add( data )

简介

使用提供的数据向表格中添加新行

参数

	名称	类型	可选
1	`数据`	`数组`	否
	数据元素数组，每个元素描述一个要添加到表格中的新行（即 `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()

简介

类型

函数 rows.add( data )

示例

相关

DataTables