CSSPrimitiveValue:getRectValue() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

CSSPrimitiveValue 介面的 getRectValue() 方法用於獲取一個矩形值。如果此 CSS 值不包含矩形值,將丟擲 DOMException。可以使用 Rect 介面來修改相應的樣式屬性。

注意:此方法是建立型別化 CSS 物件模型(Typed CSS Object Model)嘗試的一部分。該嘗試已被放棄,大多數瀏覽器並未實現它。

要實現您的目的,您可以使用

語法

js
getRectValue()

引數

無。

返回值

一個表示矩形值的 Rect 物件。

異常

型別 描述
DOMException 如果 CSS 值不包含矩形值(即,不是 CSS_RECT),則會丟擲 INVALID_ACCESS_ERR

示例

js
const cs = window.getComputedStyle(document.getElementById("clippedDiv"));
const cssValue = cs.getPropertyCSSValue("clip");
console.log(cssValue.getRectValue());

規範

此功能最初定義在 DOM Style Level 2 規範中,但此後已從任何標準化工作中刪除。

它已被現代但不相容的 CSS 型別化物件模型 API 所取代,該 API 現在已處於標準軌道。

瀏覽器相容性