{hero}

DataTable.util.set()

自 DataTables 1.11.0 起

从描述符创建写操作函数。

说明

DataTable.util.get() 相匹配,但此方法将数据写入源对象,方法使用熟悉的 JSON 表示法的描述,将数据写入复杂对象。在将数据写入行的存储库时,DataTables 在内部会使用此方法来处理 columns.data,此方法向插件和其他库公开这种能力,以便使用。

此方法返回的函数期望传入以下参数

  1. 目标对象 - 将数据写入其中的对象
  2. 值 - 将写入由描述符定义的位置中的值。
  3. 元信息 - 如果被用作函数,您希望传递给描述符的任何额外信息。

使用此方法写入数据的示例

let user = {
    name: {
        first: 'Fiona',
        last: 'Grayling'
    }
};
let fn = DataTable.util.set('name.first');

fn(user, 'Airi');
// Will replace `Fiona` with `Airi`

描述符可以表示为

  • null: 返回的函数是 no-op(无操作)函数 - 即,执行时不执行任何操作的函数。
  • 函数: 当调用时,写程序将执行以下参数描述符函数
    1. 目标对象
    2. set (DataTables 将此用于 columns.data)
    3. 要设置的值
    4. 传入的元信息
  • 字符串: 返回一个将给定值写入由 JSON 表示法字符串定义的属性的函数,与 DataTable.util.get() 具有相同的附加功能 - 也就是说,在字符串中同时支持数组语法 ([]) 和函数执行语法 (())。

类型

functionset( descriptor )

说明

根据给定的描述符构建用于设置数据的写操作函数。

返回

将用于向给定对象中设置数据的一个写操作函数。