CKTIS / JavaScript
`contains()` и `parentElement`: наследници и преки родители в DOM
`contains()` проверява дали даден възел съвпада с изходния възел или е негов наследник. `parentElement` връща прекия родител само ако той е елемент.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
container.contains(otherNode) // boolean; pass a Node or null
node.parentElement // Element or null; read-onlycontainer.contains(otherNode) връща true, ако otherNode е самият container или негов наследник на произволна дълбочина, включително текстов възел. За null връща false. Пропускането на задължителния аргумент или подаването на низ предизвиква TypeError. За да изключите самия container, използвайте otherNode !== container && container.contains(otherNode).
node.parentElement е свойство само за четене, а не метод. То връща прекия родител, ако той е от тип Element. Връща null, ако няма родител или ако родителят е от друг тип, например Document или DocumentFragment. Свойството не търси по-нагоре в дървото. За да получите прекия родител независимо от типа му, използвайте node.parentNode.
И двете операции отразяват текущата структура на дървото, дори когато то не е свързано с документа. Преместването на възел може да промени резултата. Нито една от операциите не преминава от дървото на shadow DOM към неговия хост: според contains() хостът не съдържа възлите от своето дърво на shadow DOM, а parentElement на пряко дете на ShadowRoot е null.
Това са членове на интерфейса Node в DOM, а не възможности на езика ECMAScript 2024. Наличността им зависи от това дали средата за изпълнение предоставя съответните интерфейси на DOM.
Примери
<!doctype html>
<meta charset="utf-8">
<title>Node.contains() and Node.parentElement</title>
<script>
const fragment = document.createDocumentFragment();
const section = document.createElement("section");
const span = document.createElement("span");
const text = document.createTextNode("Hello");
fragment.appendChild(section);
section.appendChild(span);
span.appendChild(text);
console.log(`section.contains(text): ${section.contains(text)}`);
console.log(`section.contains(section): ${section.contains(section)}`);
console.log(`section.contains(null): ${section.contains(null)}`);
console.log(`text.parentElement === span: ${text.parentElement === span}`);
console.log(`section.parentElement: ${section.parentElement}`);
console.log(`section.parentNode === fragment: ${section.parentNode === fragment}`);
</script>Резултат
section.contains(text): true section.contains(section): true section.contains(null): false text.parentElement === span: true section.parentElement: null section.parentNode === fragment: true
Запазете примера като файл с разширение `.html`, отворете го в браузър и проверете изхода в конзолата за разработчици. Отделеният от документа фрагмент съдържа `section`, но не е от тип `Element`. Затова `section.parentElement` е `null`, въпреки че `section.parentNode` е самият фрагмент.
Свързани уроци
- JavaScript · Урок 18 · Напреднало · Версия: 4