column().search.fixed()

自 DataTables 2.0 起

取得/設定要套用至欄位的指定搜尋。

描述

如同 search.fixed() 將「固定」搜尋詞套用至整個表格，此方法可用於將搜尋詞套用至特定欄位。

固定搜尋（也可能稱為黏性或指定搜尋）提供一種簡單的方法，可以將累加的搜尋詞加入表格。您可以加入多個獨立的搜尋詞，DataTables 會將它們組合（AND 邏輯），顯示已套用所有搜尋詞的結果。

請注意，此方法僅設定要套用至欄位的固定搜尋，它實際上並不會執行搜尋。為了執行搜尋並顯示結果，請使用 draw() 方法，它可以簡單地作為此方法的鏈式方法呼叫。

描述

參數

	名稱	類型	可選
1	`name`	`string`	否
	將其視為正規表示式（`true`）或否（預設為 `false`）。
2	`input`	`string`、`RegExp`、`function`、`null`	否
	要套用至表格的搜尋詞。使用 `null` 作為此值以刪除現有的搜尋詞。如果以字串形式給定，它將使用 DataTables 的「智慧」搜尋（請參閱 `search()`）套用至表格的搜尋。如果使用正規表示式，則給定的資料是相關欄位中單元格的搜尋資料。如果是函式，則會為每一列呼叫該函式，並傳入四個參數：表格中所有可搜尋欄位的資料搜尋字串列的原始資料物件列的資料索引欄位的資料索引應傳回布林值：`true` 保留該列，`false` 篩選掉該列。

傳回

DataTables.Api

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);