当前位置: 首页 > 中文手册 > jQuery.filter() 函数详解

jQuery.filter() 函数详解

filter()函数用于筛选出符合指定表达式的元素,并以jQuery对象的形式返回。

这里的表达式包括:选择器(字符串)、DOM元素(Element)、jQuery对象、函数。

该函数属于jQuery对象(实例)。

语法

jQueryObject.filter( expr )

参数

参数描述
exprString/Element/jQuery/Function类型指定的表达式。

如果expr参数为字符串,则将其视作jQuery选择器,用以表示该选择器所匹配的元素。

jQuery 1.4 新增支持:参数expr可以为DOM元素(Element)或jQuery对象

如果expr参数为函数,filter()函数将根据匹配的所有元素遍历执行该函数,函数中的this将指向当前迭代的元素。filter()还会为函数传入两个参数:第一个参数即当前元素在匹配元素中的索引,第二个参数就是当前元素。

迭代元素时,如果函数expr的返回值为true,则表示当前元素满足筛选条件。

返回值

filter()函数的返回值为jQuery类型,返回一个新的jQuery对象,该对象封装了当前jQuery对象的匹配元素中所有符合筛选条件的元素。

如果没有满足条件的元素,则返回空的jQuery对象。

filter()函数并不会更改当前jQuery对象的元素匹配,筛选的结果只反映在作为返回值的新的jQuery对象中。

示例&说明

filter()函数与复合选择器具有以下等价代码:

// 这里的s1、s2均表示任意的选择器
$("s1").filter("s2");
// 等价于
$("s1s2");

以下面这段HTML代码为例:

<div id="n1">
	<div id="n2" class="n2">
		<ul id="n3" data_id="12">
			<li id="n4">item1</li>
			<li id="n5" class="foo bar">item2</li>
			<li id="n6" class="level-2">item3</li>
		</ul>
	</div>
	<div id="n7" class="n7">
		<input id="n8" name="codeplayer" type="text" value="1">
		<input id="n9" name="codeplayer" type="checkbox" checked="checked" value="1">
	</div>
</div>

以下jQuery示例代码用于演示filter()函数的具体用法:

/* $("li") 匹配n4、n5、n6这3个元素 */

//筛选出所有索引为偶数(序号为奇数)的元素,即n4、n6
document.writeln( $("li").filter( ":even" ).length ); // 2
//筛选出包含类名foo的元素,即n5
document.writeln( $("li").filter( $(".foo") ).length ); // 1
//筛选出所有带有class属性的元素,即n5、n6
document.writeln( $("li").filter( "[class]" ).length ); // 2


/* $("input") 匹配n8、n9这两个元素 */

//筛选出选中的元素,即n9
document.writeln( $("input").filter( ":checked" ).length ); // 1
var input = document.getElementsByName("codeplayer");
//筛选出所有的input元素,即n8、n9
document.writeln( $("input").filter( input ).length ); // 2


//$("div") 匹配n1、n2、n7这3个元素

//筛选出id和class属性相等的元素,即n2、n7
var $result = $("div").filter( function(index, element){
	// 函数内的this === element
	return this.id == this.className; 
} );
document.writeln( $result.length ); // 2

运行代码

30 1
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。