StaticRange

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來,它已在各大瀏覽器中可用。

StaticRange 介面擴充套件了 AbstractRange,提供了一種指定 DOM 中內容範圍的方法,該範圍的內容不會更新以反映 DOM 樹內發生的變化。

此介面提供與 AbstractRange 相同的屬性和方法集。

AbstractRangeStaticRange 不能從 Web Workers 中訪問。

AbstractRange StaticRange

建構函式

StaticRange()

根據指定屬性預設值的選項,建立一個新的 StaticRange 物件。

例項屬性

以下屬性是從其父介面 AbstractRange 繼承的。

StaticRange.collapsed 只讀

返回一個布林值,如果範圍的開始和結束位置相同,則為 true,這將導致範圍長度為 0。

StaticRange.endContainer 只讀

返回包含範圍結束點的 DOM Node。節點中結束位置的偏移量由 endOffset 指示。

StaticRange.endOffset 只讀

返回一個整數值,指示 endContainer 中範圍最後一個字元所在節點的偏移量。

StaticRange.startContainer 只讀

返回包含範圍起始點的 DOM Node(起始點由 startOffset 標識)。

StaticRange.startOffset 只讀

返回一個整數值,指示 startContainer 中範圍第一個字元所在節點的偏移量。

用法說明

DOM 範圍指定文件中內容的跨度,可能從一個節點(或元素)內部開始,在另一個節點內部結束。與 Range 不同,StaticRange 代表一個固定在時間上的範圍;它不會嘗試在文件更改時保持相同的內​​容。如果對 DOM 進行任何更改,StaticRange 指定範圍內的實際資料可能會發生變化。這使得 使用者代理 可以避免許多不必要的工作,如果 Web 應用程式或站點不需要即時更新的範圍。

規範

規範
DOM
# interface-staticrange

瀏覽器相容性

另見

  • DOM 中內容的即時更新範圍:Range
  • AbstractRange,所有範圍都派生的抽象介面