CSSPrimitiveValue: Methode getRGBColorValue()
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 Methode getRGBColorValue()
der Schnittstelle CSSPrimitiveValue
wird verwendet, um einen RGB-Farbwert zu erhalten. Wenn dieser CSS-Wert keinen RGB-Farbwert enthält, wird eine DOMException
ausgelöst. Änderungen an der entsprechenden Stil-Eigenschaft können über die Schnittstelle RGBColor
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:
- das untypisierte CSS Objektmodell, das weit verbreitet unterstützt wird, oder
- die moderne CSS Typed Object Model API, die weniger unterstützt wird und als experimentell gilt.
Syntax
getRGBColorValue()
Parameter
Keine.
Rückgabewert
Ein RGBColor
Objekt, das den Farbwert darstellt.
Ausnahmen
Typ | Beschreibung |
---|---|
DOMException |
Ein INVALID_ACCESS_ERR wird ausgelöst, wenn die angehängte Eigenschaft keinen RGB-Farbwert zurückgeben kann (d.h. dies ist nicht CSS_RGBCOLOR ). |
Beispiele
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("color");
console.log(cssValue.getRGBColorValue());
Spezifikationen
Dieses Merkmal wurde ursprünglich in der DOM Style Level 2 Spezifikation definiert, wurde jedoch seitdem aus allen Standardisierungsbemühungen gestrichen.
Es wurde durch eine moderne, aber inkompatible, CSS Typed Object Model API ersetzt, die sich nun auf dem Weg zur Standardisierung befindet.
Browser-Kompatibilität
BCD tables only load in the browser