萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 遍歷方法深度解析:closest() vs parents() vs parent()

三大向上遍歷方法對比

方法搜尋起點搜尋方向停止條件回傳值典型用途
parent([selector])父元素單層向上找到父元素即停止jQuery 物件 (0 或 1 個元素)直接父層操作、表單欄位包裝器
parents([selector])父元素一路向上至 <html>到達文檔根節點jQuery 物件 (0~N 個元素,由近至遠排序)尋找所有符合條件的祖先、事件委派容器查找
closest(selector)自身一路向上至 <html>找到第一個匹配即停止jQuery 物件 (0 或 1 個元素,最近的)事件委派目標查找、元件根節點定位、表單驗證容器

核心差異圖解

<div class="wrapper">
  <div class="container">
    <form class="form">
      <div class="field-group">
        <input class="input" type="text">  <!-- 當前元素 -->
      </div>
    </form>
  </div>
</div>

關鍵差異:closest() 從「自身」開始匹配

⚠️ 易錯點

parents() 從父元素開始找;closest() 從當前元素開始找。

<div class="item active"></div>
$(".item.active").parents(".item")    // → [] 空集合(父元素無 .item)
$(".item.active").closest(".item")    // → [.item.active] (自身匹配!)

實戰場景對比

場景一:事件委派 - 找到列表項目

<ul id="list">
  <li><button class="delete-btn">刪除</button></li>
  <li><button class="delete-btn">刪除</button></li>
</ul>

$("#list").on("click", ".delete-btn", function() {
  // ❌ parents() 會找到所有祖先 li(雖然這裡只有一層)
  // var $item = $(this).parents("li"); 
  
  // ✅ closest() 精準找到最近的 li,語意明確、效能更好
  var $item = $(this).closest("li");
  $item.fadeOut(300, function() { $(this).remove(); });
});

場景二:表單驗證 - 找到欄位容器顯示錯誤

<form>
  <div class="form-group">
    <label>Email</label>
    <input type="email" class="form-control" required>
    <span class="error-msg"></span>
  </div>
</form>

$("form").on("submit", function(e) {
  $(this).find("input[required]").each(function() {
    if (!this.validity.valid) {
      // 最近的 .form-group 容器
      var $group = $(this).closest(".form-group");
      $group.addClass("has-error");
      $group.find(".error-msg").text(this.validationMessage);
    }
  });
});

場景三:元件封裝 - 從內部元素找到元件根節點

<div class="dropdown">
  <button class="dropdown-toggle">選單</button>
  <div class="dropdown-menu">
    <a class="dropdown-item" href="#">選項 1</a>
    <a class="dropdown-item" href="#">選項 2</a>
  </div>
</div>

$(".dropdown-item").on("click", function() {
  // 找到元件根節點,觸發自定義事件
  var $dropdown = $(this).closest(".dropdown");
  $dropdown.trigger("select.dropdown", [$(this).text()]);
  $dropdown.find(".dropdown-toggle").text($(this).text());
});

效能差異分析

// 測試:1000 個巢狀 div,從最內層查找 .container
var $deep = $("div").eq(999); // 最內層

console.time("parents");
$deep.parents(".container"); // 遍歷所有祖先再過濾
console.timeEnd("parents");  // ~0.8ms

console.time("closest");
$deep.closest(".container"); // 找到第一個即停止
console.timeEnd("closest");  // ~0.02ms (快 40 倍!)

// 結論:明確知道目標選擇器時,永遠優先用 closest()

進階遍歷方法補充

方法說明回傳
parentsUntil(selector)獲取祖先元素,直到遇到匹配選擇器為止(不含該選擇器)jQuery 物件
offsetParent()獲取最近的已定位祖先(position !== static)單一元素
.parent() vs .parents()單數 vs 複數,語意區分單層 vs 多層-

原生 JavaScript 等價實現

// parent() → element.parentElement
// parents() → 遞迴收集 parentElement
function getParents(el, selector) {
  const result = [];
  while ((el = el.parentElement)) {
    if (!selector || el.matches(selector)) result.push(el);
  }
  return result;
}

// closest() → Element.closest() (原生支援,IE 不支援)
if (!Element.prototype.closest) {
  Element.prototype.closest = function(s) {
    let el = this;
    do {
      if (el.matches(s)) return el;
      el = el.parentElement;
    } while (el);
    return null;
  };
}

// 使用
const container = document.querySelector(".input").closest(".form");

最佳實踐建議

  1. 知道目標選擇器 → 用 closest():語意精確、效能最佳、從自身開始符合直覺
  2. 需要所有匹配祖先 → 用 parents(selector):如「找到所有包含我的 .card」
  3. 只需直接父層 → 用 parent():如「獲取 input 的 .form-group 包裝器」
  4. 避免無選擇器 parents():回傳所有祖先至 html,極少用到且效能差
  5. 現代專案優先原生 Element.closest():無依賴、原生效能、標準化

總結

closest() 與 parents() 的核心差異在於搜尋起點(自身 vs 父元素)與停止策略(首次匹配停止 vs 遍歷全部)。實務開發中,90% 以上的向上查找場景應使用 closest(),它完美契合「從事件目標尋找處理容器」的事件委派模式,也是現代前端元件通訊(如 Dropdown、Modal、Tooltip 尋找根節點)的標準做法。

copyright © 萬盛學電腦網 all rights reserved