Selection: rangeCount 屬性

Baseline 已廣泛支援

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

Selection.rangeCount 只讀屬性返回選區中的範圍(range)的數量。

在使用者點選剛載入的頁面之前,rangeCount0。使用者點選頁面後,rangeCount1,即使沒有可見的選區。

使用者通常一次只能選擇一個範圍,因此 rangeCount 通常為 1。可以透過指令碼使選區包含多個範圍。

Gecko 瀏覽器允許跨表格單元格進行多重選擇。Firefox 允許使用者透過按住 Ctrl 鍵(除非點擊發生在具有 display: table-cell CSS 屬性的元素內)來選擇文件中的多個範圍。

一個數字。

示例

下面的示例將每秒顯示 rangeCount。在瀏覽器中選擇文字即可看到其變化。

HTML

html
<table>
  <tr>
    <td>a.1</td>
    <td>a.2</td>
  </tr>
  <tr>
    <td>b.1</td>
    <td>b.2</td>
  </tr>
  <tr>
    <td>c.1</td>
    <td>c.2</td>
  </tr>
</table>

JavaScript

js
setInterval(() => {
  console.log(window.getSelection().rangeCount);
}, 1000);

結果

開啟您的控制檯,檢視選區中有多少個範圍。在 Gecko 瀏覽器中,您可以透過按住 Ctrl 鍵(macOS 上為 Cmd 鍵)並用滑鼠拖動來跨表格單元格選擇多個範圍。

規範

規範
Selection API
# dom-selection-rangecount

瀏覽器相容性

另見