cells().every() 遍历每个选定的单元格，并且每个单元格应用传入方法里的处理文档(Options & API) DataTables中文网

描述(Description)

Datatables API经常使用的操作是对单元格集合执行操作，比如在每个单元格上执行一个通用的操作，像添加事件处理，更新数据等。可以在Datatables中使用以多种方式进行单元格的迭代，每种方式有自己的优点：

cells().every()API 方法可能在众多情况下是最有用的，将回调函数的上下文设置为相关单元格的 cell()API 实例（通常，DataTables API中的回调将其上下文设置为顶级API层次结构）。简单来说，这意味着你可以在指定给此方法的回调中使用诸如 cell().data()API 之类的方法作为this.data()。

看下面这个例子，使用 each()API ，该示例遍历已选择的单元格索引，我们需要为每个单元格获取 cell()API ，以便能够直接使用它：

table.cells().eq(0).each( function ( index ) {
    var cell = table.cell( index );
 
    var data = cell.data();
    // ... do something with data(), or cell.node(), etc
} );

使用 cells().every()API 方法，上面的代码可以改成如下样子：

table.cells().every( function () {
    var data = this.data();
    // ... do something with data(), or this.node(), etc
} );

Although a relatively simple optimisation in terms of code presentation, it can make the code much more readable and intuitive.

The other advantage is that the table context is automatically handled - in the first example above where each()API is used, the eq()API method is used to select the information from the first table in the API’s context only, introducing complexity if multiple tables are used. In cells().every()API the table context is automatically set to the appropriate table for each cell that has been selected.

类型(Type)

function cells().every( fn )

描述(Description):

遍历每一个被选择的单元格

参数(Parameters):

名称（Name）类型（Type）是否可选（Optional）

1 fn functionType no

	名称（Name）	类型（Type）	是否可选（Optional）
1	`fn`	`functionType`	no
	对每个选定的单元格执行这个函数。该函数的上下文设置为该单元格的API实例。从Datatables 1.10.8 开始，该函数将传递以下参数： 1，Cell's row index - 单元格的行索引 2，Cell's column index - 单元格的列索引 3，Table loop counter - 表格的循环计数器 4，Cell loop counter - 单元格的循环计数器 No return value is expected or acted upon.

对每个选定的单元格执行这个函数。该函数的上下文设置为该单元格的API实例。

从Datatables 1.10.8 开始，该函数将传递以下参数：

1，Cell's row index - 单元格的行索引
2，Cell's column index - 单元格的列索引
3，Table loop counter - 表格的循环计数器
4，Cell loop counter - 单元格的循环计数器

No return value is expected or acted upon.

返回(Returns):

DataTables.ApiType

Datatables API 实例，包含被选中的单元格。

例子(Example)

给满足条件的数据添加样式

var table = $('#example').DataTable();
 
table.cells().every( function () {
    if ( this.data() > 50 ) {
        $(this.node()).addClass( 'warning' );
    }
    else {
        $(this.node()).removeClass( 'warning' );
    }
} );