CodePlayer

jQuery的:contains(text)选择器用于匹配包含指定文本的元素，将其封装为jQuery对象并返回。

语法

jQuery1.1.4 新增该选择器。

// 这里的text表示具体的文本字符串
jQuery( ":contains(text)" )

参数

返回值

返回封装了匹配所有包含指定文本的元素的jQuery对象。

如果找不到任何相应的匹配，则返回一个空的jQuery对象。

如果省略了text(或者说，text为空字符串)，则返回一个空的jQuery对象。

示例&说明

以下面这段HTML代码为例：

<div id="n1">
	<div id="n2">
			<span id="n3">张三</span>
			<span id="n4">CodePlayer</span>
	</div>
	<div id="n5">
		<span id="n6">CodePlayer</span>
	</div>
	<div id="n7">
		CodePlayer
	</div>
</div>

现在，我们想要在id为n1的div标签内查找所有包含字符串"CodePlayer"的元素，则可以编写如下jQuery代码：

// 选择了id分别为n2、n4、n5、n6、n7的5个元素
// n5的子元素n6中包含"CodePlayer"，因此n5也会被计入在内
$("#n1 :contains(CodePlayer)");

接着，在id为n1的div标签内查找所有包含字符串"张三"的元素，则可以编写如下jQuery代码：

// 选择了id分别为n2、n3的两个元素
// n2的子元素n3包含"张三"，因此n2也会被计入在内
$("#n1 :contains(张三)");

运行代码