Auswahl: addRange()-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.addRange()-Methode fügt einer Selection ein Range hinzu.

Syntax

js
addRange(range)

Parameter

range

Ein Range-Objekt, das zur Selection hinzugefügt wird.

Rückgabewert

Keiner (undefined).

Beispiele

Hinweis: Derzeit unterstützt nur Firefox mehrere Auswahlbereiche, andere Browser werden keine neuen Bereiche zur Auswahl hinzufügen, wenn diese bereits einen enthält.

HTML

html
<p>
  I <strong>insist</strong> that you <strong>try</strong> selecting the
  <strong>strong words</strong>.
</p>
<button>Select strong words</button>

JavaScript

js
let button = document.querySelector("button");

button.addEventListener("click", () => {
  const selection = window.getSelection();
  const strongElems = document.getElementsByTagName("strong");

  if (selection.rangeCount > 0) {
    selection.removeAllRanges();
  }

  for (const node of strongElems) {
    const range = document.createRange();
    range.selectNode(node);
    selection.addRange(range);
  }
});

Ergebnis

Spezifikationen

Specification
Selection API
# dom-selection-addrange

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • Selection, die Schnittstelle, zu der diese Methode gehört