CKTIS / JavaScript
`contains()` in `parentElement`: potomci in neposredni starši v DOM-u
`contains()` preveri, ali je podano vozlišče isto vozlišče ali njegov potomec. `parentElement` vrne neposrednega starša samo, če je ta element.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
container.contains(otherNode) // boolean; pass a Node or null
node.parentElement // Element or null; read-onlycontainer.contains(otherNode) vrne true, če je otherNode kar container ali njegov potomec na poljubni globini, tudi če je besedilno vozlišče. Za null vrne false. Če obvezni argument izpustiš ali podaš niz, se sproži TypeError. Če želiš izključiti sam container, uporabi otherNode !== container && container.contains(otherNode).
node.parentElement je lastnost samo za branje, ne metoda. Vrne neposrednega starša, če je tipa Element. Če starša ni ali je drugega tipa, na primer Document ali DocumentFragment, vrne null. Ne išče višje po drevesu. Za neposrednega starša ne glede na tip uporabi node.parentNode.
Obe operaciji odražata trenutno zgradbo drevesa, tudi če drevo ni priključeno dokumentu. Premik vozlišča lahko spremeni rezultat. Nobena operacija ne preide iz senčnega drevesa do njegovega gostitelja: z vidika contains() gostitelj ne vsebuje vozlišč svojega senčnega drevesa, parentElement neposrednega otroka vozlišča ShadowRoot pa je null.
Oba člana pripadata vmesniku Node v DOM-u in nista del jezika ECMAScript 2024. Njuna razpoložljivost je odvisna od tega, ali izvajalno okolje zagotavlja ustrezne vmesnike DOM.
Primeri
<!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>Rezultat
section.contains(text): true section.contains(section): true section.contains(null): false text.parentElement === span: true section.parentElement: null section.parentNode === fragment: true
Primer shrani kot datoteko `.html`, odpri jo v brskalniku in preveri izpis v konzoli za razvijalce. Odklopljeni fragment vsebuje `section`, vendar ni tipa `Element`. Zato je `section.parentElement` enak `null`, čeprav je `section.parentNode` ta fragment.
Povezane lekcije
- JavaScript · Lekcija 18 · Napredna · Različica: 4