萬盛學電腦網

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

jQuery closest() 選擇器實戰:查找最近祖先元素、表單驗證、委託事件中的上下文定位

核心語法與區別

方法搜索方向包含自身返回
.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()(僅直接父級)。
copyright © 萬盛學電腦網 all rights reserved