{hero}

searchBuilder.liveSearch

自:SearchBuilder 1.6.0 起

控制即時搜尋操作。
請注意 - 此屬性需要 DataTables 的 SearchBuilder 擴充功能。

描述

預設情況下,SearchBuilder 會在每次使用者輸入操作(例如輸入文字或從下拉式選單中選擇選項)時自動重新繪製 DataTable 並套用其搜尋條件,我們稱之為即時搜尋。這可能並非總是理想的,特別是在處理大型資料集時,這可能需要大量的時間來處理搜尋條件。

此選項可用於停用 SearchBuilder 的即時搜尋操作,並在介面中新增一個搜尋按鈕。觸發此按鈕將會使表格執行由 SearchBuilder 條件設定的搜尋操作。

請注意,啟用此選項後,如果您設定了搜尋,任何導致主機 DataTable 重新繪製的操作都會觸發搜尋。這包括使用內建的全域搜尋、排序或分頁。

類型

布林值

描述

啟用 SearchBuilder 輸入的即時搜尋 (true),或停用並顯示「搜尋」按鈕以觸發搜尋操作 (false)。

預設值

  • 值:true

搜尋將在使用者輸入值時自動發生。

範例

停用即時搜尋

new DataTable('#myTable', {
	layout: {
		top1: {
			searchBuilder: {
				liveSearch: false
			}
		}
	}
});