| 方法 | 搜尋起點 | 搜尋方向 | 停止條件 | 回傳值 | 典型用途 |
|---|---|---|---|---|---|
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>
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 多層 | - |
// 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");
closest():語意精確、效能最佳、從自身開始符合直覺parents(selector):如「找到所有包含我的 .card」parent():如「獲取 input 的 .form-group 包裝器」parents():回傳所有祖先至 html,極少用到且效能差Element.closest():無依賴、原生效能、標準化closest() 與 parents() 的核心差異在於搜尋起點(自身 vs 父元素)與停止策略(首次匹配停止 vs 遍歷全部)。實務開發中,90% 以上的向上查找場景應使用 closest(),它完美契合「從事件目標尋找處理容器」的事件委派模式,也是現代前端元件通訊(如 Dropdown、Modal、Tooltip 尋找根節點)的標準做法。