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

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

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

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

jQuery синтаксис:

Синтаксис 1.4:

JavaScript

$.contains( container, contained )

container - Element

contained - Element

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

1.4

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

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

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

Функция $.contains() — пример 1

Нажмите ▶. Измените JavaScript и запустите пример повторно. Используется jQuery 3.1.1.

index.html

HTML

<section id="parent"><p id="child">Дочерний элемент</p></section>

main.js

JavaScript

const parent = document.getElementById('parent')
const child = document.getElementById('child')
console.log($.contains(parent, child))
console.log($.contains(parent, parent)) // Сам элемент не считается своим потомком.

style.css

CSS

body {
  margin: 16px;
  font:
    16px/1.5 system-ui,
    sans-serif;
  overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
  max-width: 100%;
}