CKTIS / JavaScript
`contains()` i `parentElement`: potomkowie i bezpośredni rodzic w DOM
`contains()` sprawdza, czy podany węzeł jest tym samym węzłem lub jego potomkiem. `parentElement` zwraca bezpośredniego rodzica tylko wtedy, gdy jest on elementem.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
container.contains(otherNode) // boolean; pass a Node or null
node.parentElement // Element or null; read-onlycontainer.contains(otherNode) zwraca true, gdy otherNode jest tym samym węzłem co container lub jego potomkiem na dowolnej głębokości, w tym węzłem tekstowym. Dla null zwraca false. Pominięcie wymaganego argumentu lub przekazanie ciągu znaków powoduje TypeError. Aby wykluczyć sam container, użyj otherNode !== container && container.contains(otherNode).
node.parentElement to właściwość tylko do odczytu, nie metoda. Zwraca bezpośredniego rodzica, jeśli jest on obiektem Element. Zwraca null, jeśli rodzica nie ma lub jest on innego typu, na przykład Document lub DocumentFragment. Właściwość nie szuka elementu wyżej w drzewie. Aby pobrać bezpośredniego rodzica niezależnie od jego typu, użyj node.parentNode.
Oba odczyty odzwierciedlają aktualną strukturę drzewa, nawet jeśli nie jest ono dołączone do dokumentu. Przeniesienie węzła może zmienić wynik. Żaden z tych odczytów nie przechodzi z drzewa shadow DOM do jego elementu hosta: host nie zawiera swoich węzłów shadow w rozumieniu contains(), a dziecko bezpośrednio pod ShadowRoot ma parentElement równe null.
Są to składowe interfejsu Node w DOM, a nie funkcje języka ECMAScript 2024. Ich dostępność zależy od środowiska wykonawczego i od tego, czy udostępnia ono odpowiednie API DOM.
Przykłady
<!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>Wynik
section.contains(text): true section.contains(section): true section.contains(null): false text.parentElement === span: true section.parentElement: null section.parentNode === fragment: true
Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Odłączony fragment zawiera element `section`, ale nie jest obiektem `Element`. Dlatego `section.parentElement` zwraca `null`, choć `section.parentNode` wskazuje fragment.
Powiązane lekcje
- JavaScript · Lekcja 18 · Zaawansowany · Wersja: 4