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.

Die getRectValue() Methode der CSSPrimitiveValue Schnittstelle wird verwendet, um einen Rechteckwert zu erhalten. 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 es 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. dies ist nicht CSS_RECT).

Beispiele

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

Spezifikationen

Dieses Merkmal wurde ursprünglich in der DOM Style Level 2 Spezifikation definiert, wurde jedoch seitdem aus allen Standardisierungsbemühungen herausgenommen.

Es wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich jetzt auf dem Standardpfad befindet.

Browser-Kompatibilität