row.add()

在表格中添加一行。

说明

将新数据添加到表格是动态控制 DataTable 内容的关键概念，此方法提供了执行此操作的功能。它一次只添加一行，要添加多行，请多次调用此方法，或使用此方法的多元对等函数：rows.add()。

所添加的列会受到应用于表格的排序和搜索条件影响，这将决定行在表格中的新位置和可见度。

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

请注意，返回值是 DataTables API，其中包含对已添加行的引用的（即，就像您已用 row() 选择它一样）。然后，您可以链接其他方法，如 row().data()，以获取该行的 data。方法 row().node() 也可以用，但只有在 deferRender 选项被禁用或已经绘制过表格的情况下才会返回节点。这是因为 deferRender 选项默认启用（自 2.0.0 起）以提升整体效能，并会在需要绘图时才会创建节点。

类型

范例

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

table.row
	.add({
		name: 'Tiger Nixon',
		position: 'System Architect',
		salary: '$3,120',
		start_date: '2011/04/25',
		office: 'Edinburgh',
		extn: '5421'
	})
	.draw();

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

var rowNode = table.row
	.add(['Fiona White', 32, 'Edinburgh'])
	.draw()
	.node();

$(rowNode)
	.css('color', 'red')
	.animate({ color: 'black' });

相关

以下选项目前直接关联，并且在你的应用程序开发中也可能很有用。