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 March 2017.

Die Selection.containsNode()-Methode zeigt an, ob ein bestimmter 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 dann 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 angegebene Knoten Teil der Auswahl ist, und false andernfalls.

Beispiele

Auswahl prüfen

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" style="color:transparent">SECRET</span> could it
  be?
</p>
<p id="win" hidden>You found it!</p>

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

BCD tables only load in the browser

Siehe auch

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