jQuery.contains()

109

посл. ред. 18.12.2016

Функция jQuery.contains() проверяет, является ли один элемент страницы потомком другого. Первым аргументом указывается DOM-элемент, внутри которого выполняется поиск. Он обязательно должен быть узлом элементом, иначе функция вернёт значение false. Вторым аргументом передаётся искомый элемент, который может быть как узлом элементом, так и текстовым узлом или комментарием.

Варианты использования

jQuery.contains(родительский_элемент, искомый_узел) => Boolean: Возвращает true, если элемент, переданный вторым аргументом, является потомком первого. В противном случае возвращает false.

Примеры

<html>
<head>
  <title>Функции библиотеки jQuery</title>
  <script type="text/javascript" src="js/jquery.js"></script>
</head>
<body><!-- Комментарий -->
  <p>Параграф</p>
</body>
</html>
 
<script>
var com = document.body.firstChild;
var par = document.body.firstElementChild;
var text = par.firstChild;

alert($.contains(document.body, com)); /* true, комментарий внутри <body> */
alert($.contains(document.body, par)); /* true, элемент <p> внутри <body> */
alert($.contains($('p'), text)); /* false, текстовый узел внутри <p>, но первым аргументом указан jQuery-объект, а не DOM-элемент */
</script>