Node: contains() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die contains() Methode der Node Schnittstelle
gibt einen booleschen Wert zurück, der angibt,
ob ein Knoten ein Nachfahre eines bestimmten Knotens ist, also der Knoten selbst,
einer seiner direkten Kinder (childNodes),
eines der direkten Kinder der Kinder, und so weiter.
Hinweis: Ein Knoten ist in sich selbst enthalten.
Syntax
contains(otherNode)
Parameter
Rückgabewert
Ein boolescher Wert, der true ist, wenn otherNode im Knoten enthalten ist,
und false, wenn nicht.
Wenn der otherNode Parameter null ist,
gibt contains() immer false zurück.
Beispiel
Diese Funktion überprüft, ob ein Element im Body der Seite ist. Da
contains inklusive ist und die Überprüfung, ob der Body sich selbst enthält,
nicht die Absicht von isInPage ist, wird dieser Fall ausdrücklich false
zurückgegeben.
function isInPage(node) {
return node === document.body ? false : document.body.contains(node);
}
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-node-contains① |