CSSPrimitiveValue: getRectValue() 方法
已弃用: 此功能不再推荐使用。尽管一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表,以指导您的决策。请注意,此功能可能在任何时候停止工作。
getRectValue()
方法是 CSSPrimitiveValue
接口用于获取矩形值的方法。如果此 CSS 值不包含矩形值,则会引发 DOMException
。可以使用 Rect
接口修改相应的样式属性。
注意: 此方法是创建类型化 CSS 对象模型的尝试的一部分。此尝试已放弃,大多数浏览器未实现它。
要实现您的目的,您可以使用
- 广泛支持的无类型 CSS 对象模型,或
- 现代 CSS 类型化对象模型 API,支持度较低,被认为是实验性的。
语法
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 的浏览器中加载。