cell().invalidate()

自：DataTables 1.10 起

校验 DataTables 中所选表格中的数据

描述

DataTables 保留在表格中每个表格内容的缓存信息，以提高表格操作的性能，例如订购和搜索。如果您修改单元格内容（用于 DOM 数据源表）或数组/对象值（用于 Ajax/JS 源表），DataTables 不会知道此操作已发生。此方法可用于告知 DataTables 从行的数据源重新读取信息（无论是来自 DOM 还是对象/数组 - 无论原始数据源是什么）。

更改单元格值时，可以使用 cell().data() 和 row().data() 代替使用无效方法。通常情况下，data 方法比无效方法更受青睐，因为它们使用的代码更少，但是当表的数据源是可以使用该对象自己的方法进行更新的外部对象时，无效方法就真的大放光彩了。

在 DataTables 1.10.4 之前，此方法实际上使整行无效。自 1.10.4 起，只有相关单元格无效。

类型

函数cell().invalidate( [ source ] )

描述

使所选单元格中的信息无效

参数

名称类型可选

	名称	类型	可选
1	`source`	`字符串`	是 - 缺省值：自动
	读取新数据的源数据默认情况下，DataTables 会自动从最初读取新行数据的相同源读取新数据（即 DOM 源或 JavaScript 源），但此参数可用来覆盖此操作并明确告知 DataTables 应使用哪个源读取新数据。如果您正在加载 Ajax 数据但使用 DOM 修改单元格内容，这可能会非常有用。此属性可以采用以下值 `auto` - 使用原始数据源 `data` - 使用 JavaScript 数据结构 `dom` - 使用 DOM 中当前保留的数据

source

字符串

是 - 缺省值：自动

读取新数据的源数据

默认情况下，DataTables 会自动从最初读取新行数据的相同源读取新数据（即 DOM 源或 JavaScript 源），但此参数可用来覆盖此操作并明确告知 DataTables 应使用哪个源读取新数据。如果您正在加载 Ajax 数据但使用 DOM 修改单元格内容，这可能会非常有用。

此属性可以采用以下值

auto - 使用原始数据源
data - 使用 JavaScript 数据结构
dom - 使用 DOM 中当前保留的数据

返回

DataTables.Api

在结果集中带有所选单元格引用的 DataTables API 实例

示例

增加单元格的值，然后使表格失效并重新绘制表格

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

$('#example tbody').on('click', 'td', function () {
	this.innerHTML = parseInt(this.innerHTML) + 1;
	table
		.cell(this)
		.invalidate()
		.draw();
});