CSSPrimitiveValue: getRGBColorValue() 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 getRGBColorValue()-Methode des
CSSPrimitiveValue-Interfaces 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 das
RGBColor-Interface erreicht 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 Vorhaben zu erreichen, können Sie verwenden:
- das untypisierte CSS Object Model, weit verbreitet unterstützt, oder
- das moderne CSS Typed Object Model API, weniger unterstützt und als experimentell angesehen.
Syntax
getRGBColorValue()
Parameter
Keine.
Rückgabewert
Ein RGBColor-Objekt, das den Farbwert repräsentiert.
Ausnahmen
| Typ | Beschreibung |
|---|---|
DOMException |
Ein INVALID_ACCESS_ERR wird ausgelöst, wenn die angehängte Eigenschaft keinen RGB-Farbwert zurückgeben kann (d.h. kein 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, ist jedoch seither aus allen Standardisierungsbemühungen herausgefallen.
Es wurde durch das moderne, aber inkompatible CSS Typed Object Model API ersetzt, das sich jetzt auf dem Standardweg befindet.