CSSPrimitiveValue: getRectValue() Methode
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
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 der
CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Rechteckwert abzurufen. Wenn dieser CSS-Wert keinen Rechteckwert enthält, wird eine DOMException ausgelöst.
Änderungen an der entsprechenden Stil-Eigenschaft können über die
Rect-Schnittstelle vorgenommen werden.
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 Object Model, das weitgehend unterstützt wird, oder
- das moderne CSS Typed Object Model API, das weniger unterstützt und als experimentell angesehen wird.
Syntax
getRectValue()
Parameter
Keine.
Rückgabewert
Ein Rect-Objekt, das den Rechteckwert darstellt.
Ausnahmen
| Typ | Beschreibung |
|---|---|
DOMException |
Ein INVALID_ACCESS_ERR wird ausgelöst, wenn der CSS-Wert keinen Rechteckwert 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, ist jedoch seitdem aus jedem Standardisierungsbestreben entfernt worden.
Es wurde durch die moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich nun auf dem Standardpfad befindet.