CSSPrimitiveValue: getRectValue() Methode
Deprecated
Avoid using this feature in new projects. The DOM level 2 CSS object model was excluded from the later CSS object model (CSSOM) specification. This feature may be a candidate for removal from web standards or browsers.
Consider using the following features instead: CSS object model.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die getRectValue()-Methode des CSSPrimitiveValue-Interfaces wird verwendet, um einen rect-Wert zu erhalten. Wenn dieser CSS-Wert keinen rect-Wert enthält, wird eine DOMException ausgelöst. Die Änderung der entsprechenden Stil-Eigenschaft kann über das Rect-Interface erfolgen.
Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS-Objektmodell zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren ihn nicht.
Um Ihr Ziel zu erreichen, können Sie verwenden:
- das untypisierte CSS-Objektmodell, das weitgehend unterstützt wird, oder
- das moderne CSS Typed Object Model API, das weniger unterstützt wird und als experimentell betrachtet wird.
Syntax
getRectValue()
Parameter
Keine.
Rückgabewert
Ein Rect-Objekt, das den rect-Wert darstellt.
Ausnahmen
| Typ | Beschreibung |
|---|---|
DOMException |
Ein INVALID_ACCESS_ERR wird ausgelöst, wenn der CSS-Wert keinen rect-Wert enthält. (d.h. dies ist nicht CSS_RECT). |
Beispiele
const cs = window.getComputedStyle(document.getElementById("clippedDiv"));
const cssValue = cs.getPropertyCSSValue("clip");
console.log(cssValue.getRectValue());
Spezifikationen
Dieses Feature wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, wurde jedoch seitdem aus jeglichem Standardisierungsversuch entfernt.
Es wurde durch das moderne, aber nicht kompatible CSS Typed Object Model API ersetzt, das sich jetzt auf dem Standardweg befindet.