siblings() 方法用來取得匹配集合中每個元素的所有同胞元素,並可透過選擇器進行可選的篩選。
.siblings(selector)
其中參數 selector 為字串值,包含用於匹配元素的選擇器運算式。
若給定一個代表 DOM 元素集合的 jQuery 物件,.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>
如果從第三個項目開始,尋找該元素的同胞元素:
$('li.third-item').siblings().css('background-color', 'red');
效果如下:
此處呼叫的結果是將項目 1、2、4 和 5 的背景設為紅色。由於我們未套用選擇器運算式,所有同胞元素自然都成為了物件的一部分;若套用了選擇器,則只會包含匹配的項目。
需要注意的是,原始元素並不包含在同胞元素之中。當我們打算找出 DOM 樹特定層級上的所有元素時,記住這一點很重要。
點擊這裡查看更多同胞選擇方法。