Selection: containsNode() 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 Selection.containsNode() Methode gibt an, ob ein angegebenes Knoten Teil der Auswahl ist.
Syntax
containsNode(node)
containsNode(node)
containsNode(node, partialContainment)
Parameter
node-
Der Knoten, der in der Auswahl gesucht wird.
partialContainmentOptional-
Wenn
true, gibtcontainsNode()truezurück, wenn ein Teil des Knotens Teil der Auswahl ist. Wennfalse, gibtcontainsNode()nurtruezurück, wenn der gesamte Knoten Teil der Auswahl ist. Wenn nicht angegeben, wird der Standardwertfalseverwendet.
Rückgabewert
Gibt true zurück, wenn der gegebene Knoten Teil der Auswahl ist, und false andernfalls.
Beispiele
Überprüfung der Auswahl
Dieses Snippet überprüft, ob etwas innerhalb des <body>-Elements ausgewählt ist.
console.log(window.getSelection().containsNode(document.body, true));
Das versteckte Wort finden
In diesem Beispiel erscheint eine Nachricht, wenn Sie das geheime Wort auswählen. Es verwendet addEventListener(), um auf selectionchange Ereignisse zu prüfen.
HTML
<p>Can you find the secret word?</p>
<p>Hmm, where <span id="secret">SECRET</span> could it be?</p>
<p id="win" hidden>You found it!</p>
CSS
#secret {
color: transparent;
}
JavaScript
const secret = document.getElementById("secret");
const win = document.getElementById("win");
// Listen for selection changes
document.addEventListener("selectionchange", () => {
const selection = window.getSelection();
const found = selection.containsNode(secret);
win.toggleAttribute("hidden", !found);
});
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| Selection API # dom-selection-containsnode |
Browser-Kompatibilität
Siehe auch
Selection, die Schnittstelle, zu der es gehört.