| 方法 | 搜尋範圍 | 回傳值 | 支援選擇器過濾 | 停止條件 | 典型用途 |
|---|---|---|---|---|---|
.parent([selector]) | 直接父元素(單層) | jQuery 物件(0~多個) | 是 | 到達父元素 | 包裝器、單層結構操作 |
.parents([selector]) | 所有祖先元素(至 document) | jQuery 物件(由近至遠排序) | 是 | document 根節點 | 取得所有祖先、統計層級 |
.closest(selector) | 從自身開始向上 | jQuery 物件(單一元素或空) | 必填 | 找到第一個匹配即停止 | 事件代理、找最近的容器/表單/模態框 |
.parentsUntil(selector) | 祖先元素直到匹配 selector 為止(不含該元素) | jQuery 物件 | 是 | 遇到匹配 selector 的祖先 | 區間操作、排除特定外層 |
.offsetParent() | 第一個有定位的祖先 | jQuery 物件(單一) | 否 | 找到 relative/absolute/fixed/body | 座標計算、定位基準點 |
<div class="grandparent">
<div class="parent">
<span class="child">目標</span>
</div>
</div>
$('.child').parent(); // [.parent]
$('.child').parents(); // [.parent, .grandparent, body, html]
$('.child').parents('div'); // [.parent, .grandparent]
// 事件代理經典用法:找最近的可編輯容器
$(document).on('click', '.edit-btn', function() {
var $container = $(this).closest('.editable-panel');
$container.toggleClass('editing');
});
// vs parents()
$(this).parents('.editable-panel').first(); // 需遍歷所有祖先再取第一個,效能較差
// 找 .child 到 .grandparent 之間的祖先(不含 .grandparent)
$('.child').parentsUntil('.grandparent'); // [.parent]
// 搭配 .addBack() 納入起始元素
$('.child').parentsUntil('.grandparent').addBack(); // [.child, .parent]
// 取得元素相對定位父座標
var $el = $('#target');
var offsetParent = $el.offsetParent(); // 第一個 position !== static 的祖先
var pos = $el.position(); // 相對 offsetParent 的 left/top
// 等同於:$el.offset() - offsetParent.offset()(邊框需額外計算)
注意:僅對可見元素有效(display:none 回傳 null/body)。
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>向上查找 Demo</title>
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<style>
#top_div{margin:20px} #main_div{margin:50px 20px}
.highlight{border:2px solid #999} .blue{color:blue} .bg-fcf{background:#fcf}
</style></head>
<body>
<div id="top_div">
<ul><li>新聞</li><li>網頁</li><li>貼吧</li></ul>
</div>
<div id="main_div">
<h3>標題一</h3><p>段落一</p>
<h3>標題二</h3><p>段落二</p>
<h3>標題三</h3><p>段落三</p>
</div>
<script>
$(function() {
// 1. 直接父元素加邊框
$("p").parent().addClass("highlight");
// 2. 最近的 div 變藍字
$("p").closest("div").addClass("blue");
// 3. 所有 li 的 div 祖先加背景
$("li").parents("div").addClass("bg-fcf").css("height", "40px");
// 4. p 元素自身背景
$("p").css("background", "#99c");
});
</script>
</body></html>
.closest(selector).parent().parents([selector]).parentsUntil(selector).offsetParent().parent() ≈ .offsetParent() > .closest() > .parentsUntil() > .parents()
.closest() 因短路機制通常比 .parents().filter() 快;.parents() 需遍歷至文件根節點,DOM 深度大時較慢。
向上查找是 DOM 操作高頻需求。精準選擇 parent/parents/closest/parentsUntil/offsetParent,不僅代碼語意更清晰,更能避免不必要的 DOM 遍歷開銷。事件代理請優先 .closest(),結構操作視層級選擇 .parent() 或 .parents(),座標計算唯一依賴 .offsetParent()。