jQuery 層次選擇器是 DOM 遍歷的核心工具,精準選取兄弟、後代、祖先元素。本文通過可視化 DOM 結構、實戰代碼對比、性能分析,徹底釐清 siblings()、nextAll()、prevAll()、next()、prev()、nextUntil()、prevUntil() 等方法的區別與適用場景。
<div id="container">
<div>1 - 祖先層級</div>
<div class="one"> <-- 參考節點 (current)
2 - 當前節點
<div>2_1 - 子節點</div>
<div>2_1_1 - 孫節點</div>
</div>
<div>2_2 - 子節點</div>
</div>
<div>3 - 後續兄弟</div>
<div>4 - 後續兄弟</div>
</div>
| 方法 | 選取範圍 | 方向 | 包含自身 | 返回類型 | 典型用例 |
|---|---|---|---|---|---|
.siblings([selector]) | **所有兄弟節點** (前+後) | 雙向 | ❌ | jQuery 對象 | 表單驗證高亮所有同組字段、標籤頁切換隱藏其他面板 |
.nextAll([selector]) | **之後的所有兄弟** | 向後 | ❌ | jQuery 對象 | 當前元素後的所有內容處理、無限滾動加載後續項目 |
.prevAll([selector]) | **之前的所有兄弟** | 向前 | ❌ | jQuery 對象 | 回溯前置步驟、計算前置元素數量 |
.next([selector]) | **緊鄰的下一個兄弟** | 向後 | ❌ | jQuery 對象 (0或1個) | 下一個輸入框聚焦、輪播切換下一張 |
.prev([selector]) | **緊鄰的上一個兄弟** | 向前 | ❌ | jQuery 對象 (0或1個) | 上一個輸入框、上一步操作 |
.nextUntil(stop, [filter]) | **直到遇到 stop 為止的後續兄弟** | 向後 | ❌ | jQuery 對象 | 獲取兩個標記之間的內容 (如章節內容) |
.prevUntil(stop, [filter]) | **直到遇到 stop 為止的前序兄弟** | 向前 | ❌ | jQuery 對象 | 同上,反方向 |
.children([selector]) | **直接子元素** | 向下 | ❌ | jQuery 對象 | 表單行內輸入框、列表直接子項 |
.find(selector) | **所有後代元素** | 向下遞歸 | ❌ | jQuery 對象 | 深層查找、表單所有輸入框 |
.parent([selector]) | **直接父元素** | 向上 | ❌ | jQuery 對象 | 冒泡事件委托、表單驗證容器 |
.parents([selector]) | **所有祖先元素** | 向上遞歸 | ❌ | jQuery 對象 | 查找最近的模態框、表單根節點 |
.closest(selector) | **最近的匹配祖先(含自身)** | 向上 | ✅ | jQuery 對象 (0或1個) | 事件委托找容器、表單驗證找 form |
const $one = $('.one'); // 參考節點
// 1. siblings() - 所有兄弟 (前+後),不含自身
$one.siblings().css('background', 'lightblue');
// 選中: div#1, div#3, div#4 (共3個)
// 2. nextAll() - 之後所有兄弟
$one.nextAll().css('border', '2px solid green');
// 選中: div#3, div#4 (共2個)
// 3. prevAll() - 之前所有兄弟
$one.prevAll().css('border', '2px solid orange');
// 選中: div#1 (共1個)
// 4. next() - 緊鄰下一個
$one.next().css('font-weight', 'bold'); // 或 $one.next().css(...)
// 選中: div#3 (僅1個)
// 5. prev() - 緊鄰上一個
$one.prev().css('font-style', 'italic');
// 選中: div#1 (僅1個)
// 6. 選擇器過濾
$one.siblings('.highlight'); // 兄弟中 class=highlight
$one.nextAll(':visible'); // 之後可見的兄弟
$one.prevAll('div'); // 之前的 div 兄弟
// 7. 組合鏈式
$one.nextAll().addBack() // 包含自身 + 之後所有兄弟
.filter(':even') // 偶數索引 (0-based)
.css('color', 'red');
DOM 順序: [div#1] [div.one#current] [div#2_1] [div#2_1_1] [div#2_2] [div#3] [div#4]
索引: 0 1 2 3 4 5 6
$siblings = $one.siblings() → [#1, #3, #4] (索引 0, 5, 6)
$nextAll = $one.nextAll() → [#3, #4] (索引 5, 6)
$prevAll = $one.prevAll() → [#1] (索引 0)
$next = $one.next() → [#3] (索引 5)
$prev = $one.prev() → [#1] (索引 0)
$children = $one.children() → [#2_1, #2_2] (索引 2, 4) - 直接子元素
$find = $one.find('div') → [#2_1, #2_1_1, #2_2] (索引 2, 3, 4) - 所有後代
// 兄弟節點 (雙向)
function siblings(el) {
return [...el.parentElement.children].filter(child => child !== el);
}
// 後續所有兄弟
function nextAll(el) {
const result = [];
while (el = el.nextElementSibling) result.push(el);
return result;
}
// 前序所有兄弟
function prevAll(el) {
const result = [];
while (el = el.previousElementSibling) result.push(el);
return result;
}
// 緊鄰下一個
const next = el => el.nextElementSibling;
// 緊鄰上一個
const prev = el => el.previousElementSibling;
// 直到停止條件
function nextUntil(el, stopSelector) {
const result = [];
while (el = el.nextElementSibling) {
if (el.matches(stopSelector)) break;
result.push(el);
}
return result;
}
// 最近匹配祖先 (含自身) - 替代 closest()
function closest(el, selector) {
while (el && el !== document.body) {
if (el.matches(selector)) return el;
el = el.parentElement;
}
return null;
}
圖解記住:橫向看兄弟,縱向看父子,方向決定方法名。