CSSPrimitiveValue: getRectValue() 方法

已弃用: 此功能不再推荐使用。尽管一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表,以指导您的决策。请注意,此功能可能在任何时候停止工作。

getRectValue() 方法是 CSSPrimitiveValue 接口用于获取矩形值的方法。如果此 CSS 值不包含矩形值,则会引发 DOMException。可以使用 Rect 接口修改相应的样式属性。

注意: 此方法是创建类型化 CSS 对象模型的尝试的一部分。此尝试已放弃,大多数浏览器未实现它。

要实现您的目的,您可以使用

语法

js
getRectValue()

参数

无。

返回值

一个表示矩形值的 Rect 对象。

异常

类型 描述
DOMException 如果 CSS 值不包含 Rect 值,则会引发 INVALID_ACCESS_ERR。 (即这并非 CSS_RECT)。

示例

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

规范

此功能最初在 DOM 样式级别 2 规范中定义,但此后已从任何标准化工作中删除。

它已被一个现代的、但不兼容的 CSS 类型化对象模型 API 取代,该 API 现在正在标准化轨道上。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。