jQuery функция $.contains()

Определение и применение

jQuery функция $.contains() позволяет проверить и возвратить логическое значение, которое определяет является ли элемент DOM потомком другого элемента DOM.

Функция $.contains() возвращает логическое значение true в том случае, если элемент DOM, предоставленный вторым аргументом, является потомком элемента DOM предоставленного первым аргументом, в противном случае возвращается логическое значение false. Если второй аргумент является текстовым узлом, или узлом комментария, то функции $.contains() вернет false. Поддерживаются только узлы элементов.

Обращаю Ваше внимание, что первый аргумент функции $.contains() обязательно должен быть элемент DOM, а не объектом jQuery, или JavaScript объектом.

jQuery синтаксис:

Синтаксис 1.4:
$.contains( container, contained )

container - Element
contained - Element

Добавлен в версии jQuery

1.4

Значения параметров

Параметр	Описание
container	Элемент DOM, который может содержать другой элемент.
contained	Элемент DOM, который может содержаться (являться потомком) другого элемента.

Пример использования

<body>
	<p>Абзац</p>
	<ul>
		<li>Элемент списка</li>
	</ul>
</body>

$.contains( document.body, $("p")[0] ); // true
$.contains( document.body, $("li")[0] ); // true
$.contains( $("ul")[0], document.getElementsByTagName("li")[0] ); // true
$.contains( document.documentElement, document.body ); // true
$.contains( document.body, document.documentElement ); // false

jQuery утилиты