核心語法與區別
| 方法 | 搜索方向 | 包含自身 | 返回 |
.closest(selector) | 向上(祖先鏈) | ✅ 是 | 單個 jQuery 對象(首個匹配) |
.parents(selector) | 向上(所有祖先) | ❌ 否 | jQuery 集合(所有匹配) |
.parent(selector) | 僅父級 | ❌ 否 | jQuery 集合(0或1個) |
.find(selector) | 向下(後代) | ❌ 否 | jQuery 集合 |
經典應用場景
1. 表單驗證:從 input 找到父表單/字段容器
$('input').on('blur', function() {
var $field = $(this).closest('.form-field'); // 字段容器
var $form = $(this).closest('form'); // 表單根節點
if (!this.value.trim()) {
$field.addClass('has-error').find('.error-msg').text('必填');
} else {
$field.removeClass('has-error');
}
// 提交時驗證整個表單
$form.on('submit', function(e) {
var valid = true;
$(this).find('input[required]').each(function() {
if (!this.value.trim()) {
$(this).closest('.form-field').addClass('has-error');
valid = false;
}
});
if (!valid) e.preventDefault();
});
});
2. 事件委託中定位數據行
<table id="dataTable">
<tbody>
<tr data-id="1"><td>...</td><td><button class="delete">刪除</button></td></tr>
<tr data-id="2"><td>...</td><td><button class="delete">刪除</button></td></tr>
</tbody>
</table>
$('#dataTable').on('click', '.delete', function() {
// 從按鈕向上找最近的 tr
var $row = $(this).closest('tr');
var id = $row.data('id');
if (confirm('確定刪除 ID:' + id + '?')) {
$row.fadeOut(300, function() { $(this).remove(); });
// $.post('/api/delete', { id });
}
});
3. 下拉菜單/彈層:點擊外部關閉
$(document).on('click', function(e) {
var $dropdown = $('.dropdown.open');
// 如果點擊目標不在 dropdown 內部,且不是觸發按鈕
if (!$dropdown.length) return;
var $target = $(e.target);
if (!$target.closest('.dropdown').length) {
$dropdown.removeClass('open');
}
});
4. 麵包屑/導航高亮:從當前頁面找到對應菜單項
// 頁面加載時,根據 URL 高亮側邊欄菜單
var currentPath = location.pathname;
$('#sidebar a[href="' + currentPath + '"]').closest('li').addClass('active')
.closest('ul').addClass('in').prev('a').addClass('active'); // 展開父級
完整驗證頁
<!DOCTYPE html>
<html><head><meta charset="utf-8"><script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script><style>
.form-field { margin:10px 0; padding:10px; border:1px solid #ddd; }
.has-error { border-color: #e74c3c; }
.error-msg { color: #e74c3c; font-size: 12px; }
table { border-collapse: collapse; width: 100%; }
td, th { border: 1px solid #ddd; padding: 8px; }
</style></head><body>
<form id="demoForm">
<div class="form-field">
<label>用戶名: <input name="username" required></label>
<span class="error-msg"></span>
</div>
<div class="form-field">
<label>郵箱: <input name="email" type="email" required></label>
<span class="error-msg"></span>
</div>
<button type="submit">提交</button>
</form>
<hr>
<table id="dataTable">
<thead><tr><th>ID</th><th>名稱</th><th>操作</th></tr></thead>
<tbody>
<tr data-id="101"><td>101</td><td>項目一</td><td><button class="delete">刪除</button></td></tr>
<tr data-id="102"><td>102</td><td>項目二</td><td><button class="delete">刪除</button></td></tr>
</tbody>
</table>
<script>
// 表單驗證
$('#demoForm input[required]').on('blur', function() {
var $field = $(this).closest('.form-field');
if (!this.value.trim()) $field.addClass('has-error').find('.error-msg').text('必填');
else $field.removeClass('has-error');
});
$('#demoForm').on('submit', function(e) {
var valid = true;
$(this).find('input[required]').each(function() {
if (!this.value.trim()) {
$(this).closest('.form-field').addClass('has-error');
valid = false;
}
});
if (!valid) e.preventDefault();
else alert('提交成功');
});
// 表格委託刪除
$('#dataTable').on('click', '.delete', function() {
var $row = $(this).closest('tr');
var id = $row.data('id');
if (confirm('刪除 ' + id + '?')) $row.remove();
});
</script>
</body></html>
原生 JS 對應:Element.closest()
// 現代瀏覽器原生支援 (IE 不支援,需 Polyfill)
var field = input.closest('.form-field');
var form = input.closest('form');
var row = button.closest('tr');
// Polyfill (IE11)
if (!Element.prototype.closest) {
Element.prototype.closest = function(s) {
var el = this;
do {
if (el.matches(s)) return el;
el = el.parentElement;
} while (el);
return null;
};
}
總結
.closest() 是向上查找最近匹配祖先的標準工具,包含自身、停止於首個匹配。
- 核心場景:表單字段容器定位、委託事件中找數據行、彈層外部點擊關閉、導航高亮。
- 原生
Element.closest() 已成標準,新項目優先使用,舊環境引入 Polyfill。
- 區別
.parents()(所有匹配祖先)與 .parent()(僅直接父級)。