CSSPrimitiveValue: Methode getRGBColorValue()
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 Methode getRGBColorValue() des Interfaces CSSPrimitiveValue wird verwendet, um einen RGB-Farbwert abzurufen. Wenn dieser CSS-Wert keinen RGB-Farbwert enthält, wird eine DOMException ausgelöst. Die entsprechende Style-Eigenschaft kann über das Interface RGBColor geändert werden.
Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS Object Model zu entwickeln. Dieser Ansatz wurde aufgegeben, und die meisten Browser implementieren die Methode nicht.
Stattdessen können Sie Folgendes verwenden:
- das nicht typisierte CSS Object Model, das weithin unterstützt wird, oder
- die moderne CSS Typed Object Model API, die weniger breit unterstützt wird und als experimentell gilt.
Syntax
getRGBColorValue()
Parameter
Keine.
Rückgabewert
Ein RGBColor-Objekt, das den Farbwert darstellt.
Ausnahmen
| Typ | Beschreibung |
|---|---|
DOMException |
INVALID_ACCESS_ERR wird ausgelöst, wenn die zugehörige Eigenschaft keinen RGB-Farbwert zurückgeben kann (d.h. wenn sie nicht CSS_RGBCOLOR ist). |
Beispiele
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("color");
console.log(cssValue.getRGBColorValue());
Spezifikationen
Diese Funktion wurde ursprünglich in der Spezifikation DOM Style Level 2 definiert, wird seither jedoch in keinem Standardisierungsverfahren mehr berücksichtigt.
Sie wurde durch die moderne, aber inkompatible CSS Typed Object Model API abgelöst, die sich derzeit im Standardisierungsprozess befindet.