DOM
Node 接口的 contains() 方法返回一个布尔值,表示一个节点是否是给定节点的后代,即该节点本身、其直接子节点(Node.childNodes)、子节点的直接子节点等。
[!NOTE] 节点包含在自身内部。
语法
contains(otherNode)
参数
otherNode-
: 要测试的节点。
[!NOTE]
otherNode不是可选的,但是可以设置为null。
-
返回值
返回一个布尔值,如果 otherNode 包含在节点中会返回 true,否则返回 false。
如果 otherNode 参数为 null,则 contains() 始终返回 false。
示例
下面的函数用来检查一个元素是否是 body 元素的后代元素。由于 contains 会包含元素自身,而确定 body 是否包含自身不是设计 isInPage 的意图,这种情况明确返回 false。
function isInPage(node) {
return node === document.body ? false : document.body.contains(node);
}
规范
浏览器兼容性
参见
- Node.compareDocumentPosition
- Node.hasChildNodes
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
