# jQuery.contains()

所属分类：工具类 英文文档：jQuery.contains()

## jQuery.contains( container, contained )返回: Boolean

描述: 检查一个DOM元素是另一个DOM元素的后代。

- #### 添加的版本: 1.4jQuery.contains( container, contained )

  - container
    类型: Element
    DOM元素作为容器，可以包含其他元素
  - contained
    类型: Element
    DOM元素，可能被其他元素所包含

如果第二个参数所提供的DOM元素是第一个参数DOM元素的后裔，那么`$.contains()` 方法返回`true`，无论是直接的子元素或者是后代元素。否则，返回`false`。只支持 element 节点;如果第二个参数是一个文本或注释节点，`$.contains()`将返回 `false`。

> 注意: 第一个参数必须是一个DOM元素，不是一个jQuery对象或普通的JavaScript对象。

## 例子:

#### 检测一个元素是否在另一个元素之内。 不支持文档和注释节点。

1 2 |
    $.contains( document.documentElement, document.body ); // true$.contains( document.body, document.documentElement ); // false