大网数据广告活动
Web 标准与前端开发

Selection:containsNode() 方法

· 52CE 我爱测

`Selection.containsNode()`** 方法用于指示指定节点是否属于当前选区。

DOM

Selection.containsNode() 方法用于指示指定节点是否属于当前选区。

语法

containsNode(node)
containsNode(node)
containsNode(node, partialContainment)

参数

  • node
    • : 要检查是否在选区中的节点。
  • partialContainment
    • : 当为 true 时,只要节点的部分内容在选区中,containsNode() 就会返回 true;当为 false 时,只有当整个节点都在选区中时,containsNode() 才会返回 true。如果未指定,则默认值为 false。

返回值

如果指定节点属于选区,则返回 true;否则返回 false。

示例

检查是否有选区

此代码片段检查 body 元素内部是否有任何内容被选中。

console.log(window.getSelection().containsNode(document.body, true));

寻找隐藏的单词

在此示例中,当你选中那个秘密单词时,会显示一条消息。代码使用 EventTarget/addEventListener 来监听 Document/selectionchange_event 事件。

HTML

<p>你能找到那个秘密单词吗?</p>
<p>嗯,它会不会在 <span id="secret">SECRET</span> 这里?</p>
<p id="win" hidden>你找到了!</p>

CSS

#secret {
  color: transparent;
}

JavaScript

const secret = document.getElementById("secret");
const win = document.getElementById("win");

// 监听选区变化
document.addEventListener("selectionchange", () => {
  const selection = window.getSelection();
  const found = selection.containsNode(secret);

  win.toggleAttribute("hidden", !found);
});

结果

寻找隐藏的单词

规范

浏览器兼容性

参见

  • 所属的 Selection 接口。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。