返回值:jQuerysiblings([selector])
查找匹配元素集合中每个元素的兄弟元素,可以提供一个可选的选择器。
-
1.0 新增siblings([selector])
selector (Selector) 可选参数,用于匹配元素的选择器表达式字符串。
若一个 jQuery 对象代表了一个 DOM 元素集合,.siblings()
方法允许我们在 DOM 树中查找集合中这些元素的兄弟元素,并根据匹配的元素创建一个新的 jQuery 对象。
该方法还可以接受一个可选的选择器表达式,该选择器表达式可以是任何可传给 $()
函数的选择器表达式。如果提供了选择器表达式,那么会先测试该元素是否满足匹配的选择器表达式。
例如,在页面中有如下一个简单的列表:
<ul> <li>list item 1</li> <li>list item 2</li> <li class="third-item">list item 3</li> <li>list item 4</li> <li>list item 5</li> </ul>
如果我们从 item 3 开始,我们可以向下面这样,查找它的兄弟元素:
$('li.third-item').siblings().css('background-color', 'red');
其结果是 item 1, item 2, item 4, 和 item 5 的背景色变成了红色。由于我们没有提供选择器表达式,因此所有的兄弟元素都是结果对象中的一部分。如果我们提供了选择器,那么只有上述四个列表项中,满足选择器的元素才会被包含在结果对象中。
原始元素并不会包含在结果对象中,要特别注意这一点,尤其是我们希望查找 DOM 中,在特殊层次上的所有元素时。
示例:
查找 3 个列表中,所有黄色 li 元素的独一无二的的兄弟元素 (如果条件适当的话,还包括其它黄色 li 元素)。
<!DOCTYPE html>
<html>
<head>
<style>
ul { float:left; margin:5px; font-size:16px; font-weight:bold; }
p { color:blue; margin:10px 20px; font-size:16px; padding:5px;
font-weight:bolder; }
.hilite { background:yellow; }
</style>
<script src="jquery.min.js"></script>
</head>
<body>
<ul>
<li>One</li>
<li>Two</li>
<li class="hilite">Three</li>
<li>Four</li>
</ul>
<ul>
<li>Five</li>
<li>Six</li>
<li>Seven</li>
</ul>
<ul>
<li>Eight</li>
<li class="hilite">Nine</li>
<li>Ten</li>
<li class="hilite">Eleven</li>
</ul>
<p>Unique siblings: <b></b></p>
<script>
var len = $(".hilite").siblings()
.css("color", "red")
.length;
$("b").text(len);
</script>
</body>
</html>
演示:
示例:
查找每个含有 "selected" 样式的 div 的所有兄弟元素。
<!DOCTYPE html>
<html>
<head>
<script src="jquery.min.js"></script>
</head>
<body>
<div><span>Hello</span></div>
<p class="selected">Hello Again</p>
<p>And Again</p>
<script>
$("p").siblings(".selected").css("background", "yellow");
</script>
</body>
</html>