Selection: addRange() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

Selection.addRange() 方法將一個 Range 物件新增到 Selection 物件中。

語法

addRange(range)

引數

range: 將要新增到 Selection 中的 Range 物件。

返回值

無（undefined）。

示例

注意： 目前只有 Firefox 支援多個選區範圍，如果選擇區域已包含一個範圍，其他瀏覽器將不會新增新的範圍。

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

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);
  }
});

結果

規範

規範
Selection API # dom-selection-addrange

瀏覽器相容性

另見

Selection，該方法所屬的介面

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2024年10月16日⁩，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題