CSSPrimitiveValue: Methode getRectValue()

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Die getRectValue()-Methode der CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Rechteckwert zu erhalten. Wenn dieser CSS-Wert keinen Rechteckwert enthält, wird ein DOMException ausgelöst. Änderungen an der entsprechenden Stil-Eigenschaft können mithilfe der Rect-Schnittstelle vorgenommen werden.

Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS Object Model zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren ihn nicht.

Um Ihr Ziel zu erreichen, können Sie verwenden:

Syntax

js
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. es ist nicht CSS_RECT).

Beispiele

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

Spezifikationen

Diese Funktion wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, wurde aber seitdem aus jeglichen Standardisierungsbemühungen entfernt.

Sie wurde durch eine moderne, aber inkompatible, CSS Typed Object Model API ersetzt, die nun auf dem Standardpfad ist.

Browser-Kompatibilität

BCD tables only load in the browser