浏览器与 Web API / 系统课时
closest、matches 与 contains
closest、matches 与 contains
界面事件经常从按钮内部的图标或文字触发,代码却需要找到完整按钮、所属卡片并确认它仍在指定容器中。本课将组合 closest、matches 与 contains,建立从事件目标到业务元素的可靠判断链路。
学习目标
- 使用
closest()从当前元素向上查找最近的匹配祖先 - 使用
matches()判断当前元素是否符合指定 CSS 选择器 - 使用
contains()验证节点是否位于目标容器内部
三个方法分别判断什么
matches(selector) 只检查当前元素本身,返回布尔值。closest(selector) 先检查当前元素,再逐层检查父元素,直到找到最近匹配项或返回 null。contains(node) 不解析选择器,而是判断一个节点是否包含另一个节点。

三个方法的返回值不同:matches() 和 contains() 返回 true 或 false,closest() 返回元素或 null。另外,closest() 会把调用者自身纳入匹配范围,而 container.contains(container) 也会返回 true,这两个边界在编写条件判断时容易被忽略。
完整示例:事件委托定位按钮
下面的页面把点击监听器注册在 document 上。即使实际点击的是按钮内部的 span,也能先定位操作按钮,再确认按钮属于课程列表,最后检查所属卡片是否处于启用状态。
<!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>预期输出
已打开:DOM 遍历组合顺序与防御性判断
常用顺序是“先 closest() 定位,再 contains() 限定范围,最后 matches() 检查状态”。若先访问 closest() 的结果而没有判空,未匹配时会触发空值错误;若省略包含关系检查,注册在更大范围上的委托监听器可能误处理其他区域的同类按钮。
matches() 和 closest() 接收 CSS 选择器,选择器语法无效时会抛出 SyntaxError,因此动态选择器应由可信规则生成。contains() 接收节点对象而不是选择器;传入同一个节点会得到 true,需要判断“严格后代”时还要附加 container !== node。
使用场景与边界
closest() 适合从图标、文字或深层子元素回到按钮、表单行、卡片和弹窗;matches() 适合验证状态类、数据属性或允许处理的元素类型;contains() 适合限制事件委托、焦点移动和浮层点击的作用范围。
这三个方法都基于当前 DOM 树关系。元素移动到其他容器后,contains() 的结果会立即改变;被移除的卡片即使仍保留 JavaScript 引用,也不再属于原列表,因此异步处理前可重新验证包含关系。