浏览器与 Web API / 系统课时

closest、matches 与 contains

closest、matches 与 contains

界面事件经常从按钮内部的图标或文字触发,代码却需要找到完整按钮、所属卡片并确认它仍在指定容器中。本课将组合 closest、matches 与 contains,建立从事件目标到业务元素的可靠判断链路。

学习目标

  • 使用 closest() 从当前元素向上查找最近的匹配祖先
  • 使用 matches() 判断当前元素是否符合指定 CSS 选择器
  • 使用 contains() 验证节点是否位于目标容器内部

三个方法分别判断什么

matches(selector) 只检查当前元素本身,返回布尔值。closest(selector) 先检查当前元素,再逐层检查父元素,直到找到最近匹配项或返回 null。contains(node) 不解析选择器,而是判断一个节点是否包含另一个节点。

closest、matches 与 contains 的作用范围

三个方法的返回值不同:matches() 和 contains() 返回 true 或 false,closest() 返回元素或 null。另外,closest() 会把调用者自身纳入匹配范围,而 container.contains(container) 也会返回 true,这两个边界在编写条件判断时容易被忽略。

完整示例:事件委托定位按钮

下面的页面把点击监听器注册在 document 上。即使实际点击的是按钮内部的 span,也能先定位操作按钮,再确认按钮属于课程列表,最后检查所属卡片是否处于启用状态。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>关系判断示例</title>
</head>
<body>
  <ul id="course-list">
    <li class="course-card" data-status="active">
      <strong>DOM 遍历</strong>
      <button data-action="open"><span>打开</span></button>
    </li>
    <li class="course-card" data-status="disabled">
      <strong>旧版课程</strong>
      <button data-action="open"><span>打开</span></button>
    </li>
  </ul>
  <pre id="output"></pre>

  <script>
    const list = document.querySelector("#course-list");
    const output = document.querySelector("#output");

    document.addEventListener("click", (event) => {
      if (!(event.target instanceof Element)) return;

      // 从实际点击位置向上定位业务按钮
      const action = event.target.closest("button[data-action]");
      if (!action || !list.contains(action)) return;

      const card = action.closest(".course-card");
      if (!card || !card.matches('[data-status="active"]')) {
        output.textContent = "当前课程不可打开";
        return;
      }

      output.textContent = `已打开:${card.querySelector("strong").textContent}`;
    });

    document.querySelector('[data-status="active"] span').click();
  </script>
</body>
</html>

预期输出

text
已打开:DOM 遍历

组合顺序与防御性判断

常用顺序是“先 closest() 定位,再 contains() 限定范围,最后 matches() 检查状态”。若先访问 closest() 的结果而没有判空,未匹配时会触发空值错误;若省略包含关系检查,注册在更大范围上的委托监听器可能误处理其他区域的同类按钮。

matches() 和 closest() 接收 CSS 选择器,选择器语法无效时会抛出 SyntaxError,因此动态选择器应由可信规则生成。contains() 接收节点对象而不是选择器;传入同一个节点会得到 true,需要判断“严格后代”时还要附加 container !== node。

使用场景与边界

closest() 适合从图标、文字或深层子元素回到按钮、表单行、卡片和弹窗;matches() 适合验证状态类、数据属性或允许处理的元素类型;contains() 适合限制事件委托、焦点移动和浮层点击的作用范围。

这三个方法都基于当前 DOM 树关系。元素移动到其他容器后,contains() 的结果会立即改变;被移除的卡片即使仍保留 JavaScript 引用,也不再属于原列表,因此异步处理前可重新验证包含关系。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

closest、matches 与 contains

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通