Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Selection: Methode addRange()

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

Syntax

js
addRange(range)

Parameter

range

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

Rückgabewert

Keiner (undefined).

Beispiele

Beachten Sie, dass nur Firefox mehrere Auswahlbereiche unterstützt. In diesem Beispiel werden andere Browser keine neuen Bereiche zur Auswahl hinzufügen, wenn bereits einer enthalten ist.

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

Spezifikation
Selection API
# dom-selection-addrange

Browser-Kompatibilität

Siehe auch

  • Selection, das Interface, zu dem diese Methode gehört