{hero}

语言.搜索

自 DataTables 1.10 起

搜索输入字符串。

说明

设置用于 DataTables 筛选输入控件的字符串。可由 search.text 字符串覆盖,针对特定筛选输入控件。

如果字符串中使用了标记 _INPUT_,则该标记会被筛选输入的 HTML 文本框替代,从而控制其在字符串中的显示位置。如果未指定 _INPUT_,则会自动将输入框追加到字符串中。

从 DataTables 2 开始,生成的 DOM 结构会根据字符串中 _INPUT_ 标记的位置而改变。如果该标记位于字符串的开始或结尾,则生成的 DOM 会使 input 位于 label 的外部。这样做是为了提高可访问性,从而允许在 inputlabel 之间建立明确的链接(有关详细信息,请参阅这篇文章)。

如果该标记位于字符串的中间,则创建的 DOM 结构会在 label 中嵌套 input,从而创建一个隐式链接(尽管仍然设置了 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'
	}
});

相关

下列选项是直接相关的,在您的应用程序开发中也可能很有用。