columns().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
	.columns()
	.search.fixed()
	.toArray();

取得預期的搜尋詞彙

let search = table.columns([1, 4]).search.fixed('mySearch');

套用搜尋字串

table.columns('.cities').search.fixed('myString', 'Paris');

將搜尋正規表示式套用至欄位索引 0 和 1

table.columns([0, 1]).search.fixed('myRegex', /l.*n/i);

將搜尋函數套用至多個欄位

table.columns('.number').search.fixed('myFunc', (cell, data) => {
	return cell > 50;
});

從所有欄位刪除現有的搜尋詞彙

table.columns().search.fixed('mySearch', null);