JQuery.index()分析
index()
函数用于获取当前jQuery对象中指定DOM元素的索引值。
该函数属于jQuery
对象(实例)。
语法
jQueryObject.index( [ object ] )
参数
参数 | 描述 |
---|---|
object | 可选/String/Element/jQuery类型表示指定元素的对象。 |
jQuery 1.4新增支持:可以不指定object
参数、object
参数可以为字符串(选择器)。
参数object
可以是DOM元素、jQuery对象或字符串。如果参数object
是字符串,则将其视作jQuery选择器,表示该选择器所匹配的元素。
返回值
index()
方法的返回值为Number类型,返回指定元素的索引位置(从0开始算起)。
注意:以下文本描述中的当前元素
表示当前jQuery对象的第一个元素。
-
如果没有指定参数
object
,则返回当前元素
在其所有同辈元素中的索引位置。 -
如果
object
为String类型,则将其视作选择器,返回当前元素
在选择器所匹配的元素中的索引位置。如果该选择器不匹配任何元素或者当前元素
不在匹配到的元素内,则返回-1。 -
如果
object
为DOM元素或jQuery对象,则返回该元素(或该jQuery对象中的第一个元素)在当前jQuery对象所匹配的元素中的索引位置。
示例&说明
以下面这段HTML代码为例:
<div id="n1">
<div id="n2">
<span id="n3"></span>
<ul id="n4">
<li id="n5">item1</li>
<li id="n6">item2</li>
<li id="n7">item3</li>
</ul>
<span id="n8"></span>
</div>
</div>
我们编写如下jQuery示例代码,来详细介绍index()
函数。
// 省略参数: 返回第一个li元素在所有同辈元素中的索引
document.writeln( $("li").index( ) ); // 0
// 参数为DOM元素: 返回n6在$li中的索引
document.writeln( $("li").index( document.getElementById("n6") ) ); // 1
// 参数为jQuery对象: 返回$("#n7")在$li中的索引
document.writeln( $("li").index( $("#n7") ) ); // 2
// 参数为选择器字符串: 返回$li中的第一个元素(即n5)在选择器"#n4"所匹配的元素中的索引
// 选择器"#n4"匹配的元素只有n4一个,没有n5,因此返回-1
document.writeln( $("li").index( "#n4" ) ); // -1
// 省略参数:n4在同辈元素中的索引,n4之前的同辈元素有一个n3,因此返回索引为1
document.writeln ( $("#n4").index( ) ); // 1
// 参数为选择器字符串:n8在选择器"span"所匹配的元素中的索引
// 选择器"span"匹配n3、n8两个元素,n8是其中的第二个元素,因此返回索引为1
document.writeln ( $("#n8").index( "span" ) ); // 1
如果有兴趣,可以在ul增加一个 span,再运行看结果。 可以把ul、li 换成div,再试试