column().search.fixed()
自:DataTables 2.0
获取/设定要应用于某一列的已命名的搜索。
描述
就像 search.fixed()
针对整个表格应用“固定”搜索词一样,此方法可用于针对特定列应用搜索词。
固定搜索(也称为粘性或已命名搜索)提供了一种方法,可轻松地向表格添加累积搜索词。您可以添加多个独立的搜索词,而 DataTables 将结合这些搜索词(AND 逻辑),显示已应用的所有搜索词的结果。
请注意,此方法设定固定搜索仅应用于该列,但不会实际执行搜索。为了执行搜索并显示结果,请使用 draw()
方法,可以简单地作为该方法的链式方法来调用。
类型
function column().search.fixed( name, searchTerm )
- 描述
- 参数
名称 类型 可选 1 name
否 作为正则表达式 (
true
) 或否 (默认,false
)。2 input
否 要应用于表格的搜索词。
使用
null
作为此值可删除现有的搜索词。如果作为字符串给出,则会使用 DataTables 的“智能”搜索应用于表格搜索(见
search()
)。如果使用正则表达式,则给定的数据是相关列中单元格搜索数据。
如果使用函数,则会针对每行调用该函数,同时传入四个参数
- 表格所有可搜索列的数据中搜索字符串
- 行的原始数据对象
- 行的 dataIndex
- 列的 dataIndex
应返回布尔值:
true
保留行,false
过滤掉该行。- 返回
DataTables API 实例
范例
获取当前搜索名称的数组
let table = new DataTable('#myTable');
let searches = table
.column(0)
.search.fixed()
.toArray();
获取预期的搜索词
let search = table.column(1).search.fixed('mySearch');
应用搜索字符串
table.column('.cities').search.fixed('myString', 'Paris');
应用搜索正则表达式
table.column(0).search.fixed('myRegex', /l.*n/i);
应用搜索函数
table.column(-1).search.fixed('myFunc', (cell, data) => {
return cell > 50;
});
删除现有的搜索词
table.column(0).search.fixed('mySearch', null);
相关项
以下选项直接相关,且在您的应用程序开发中也可能有用。