Selection: containsNode() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Selection.containsNode() Methode gibt an, ob ein angegebenes Knoten Teil der Auswahl ist.

Syntax

js
containsNode(node)
containsNode(node)
containsNode(node, partialContainment)

Parameter

node

Der Knoten, der in der Auswahl gesucht wird.

partialContainment Optional

Wenn true, gibt containsNode() true zurück, wenn ein Teil des Knotens Teil der Auswahl ist. Wenn false, gibt containsNode() nur true zurück, wenn der gesamte Knoten Teil der Auswahl ist. Wenn nicht angegeben, wird der Standardwert false verwendet.

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.

js
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

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

css
#secret {
  color: transparent;
}

JavaScript

js
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

Specification
Selection API
# dom-selection-containsnode

Browser-Kompatibilität

Siehe auch

  • Selection, die Schnittstelle, zu der es gehört.