{hero}

語言.搜尋

自:DataTables 1.10

搜尋輸入字串。

描述

設定用於 DataTables 過濾輸入控制的字串。它可被特定搜尋輸入控制的 search.text 字串覆寫。

字串中的 _INPUT_ 符號,若有使用,會被替換為 HTML 文字輸入框,以便控制它在字串中的顯示位置。如果沒有給定 _INPUT_,則輸入框會自動附加到字串的末尾。

自 DataTables 2 開始,產生的 DOM 結構可能會根據字串中 _INPUT_ 符號的位置而改變。如果該符號在字串的開頭或結尾,生成的 DOM 將使 input 位於 label 之外。這樣做是為了方便存取,允許 inputlabel 之間建立*明確的*連結(詳見這篇文章)。

如果該符號位於字串的中間,則創建的 DOM 結構將使 input 嵌套在 label 中,從而建立一個*隱含的*連結(儘管 forid 屬性仍然被設定)。一些螢幕閱讀器可能會難以處理這種形式,因此不建議使用。

這種 DOM 結構的區別僅在您要對頁面應用自定義樣式時才重要。您*可能*需要根據使用的字串來修改您的 CSS。

此外,此屬性可以利用 language.entries 來輕鬆更新字串,使其與表格中顯示的特定數據類型相關。它的複數形式將始終解析為複數萬用字元。您希望解析後的 language.entries 值顯示的位置應使用 _ENTRIES_ 替換符號。

類型

此選項可以以以下類型給定

預設值

  • 值:搜尋:

範例

文字輸入框會自動附加在末尾

new DataTable('#myTable', {
	language: {
		search: 'Filter records:'
	}
});

使用 language.entries 的自定義文字

new DataTable('#myTable', {
	language: {
		search: 'Filter _ENTRIES_:'
	}
});

指定過濾器應顯示的位置

new DataTable('#myTable', {
	language: {
		search: 'Apply filter _INPUT_ to table'
	}
});

相關

以下選項直接相關,可能在您的應用程式開發中也很有用。