CSSPrimitiveValue: setStringValue() method
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.
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
The setStringValue() method of the
CSSPrimitiveValue interface is used to set a string value. If the
property attached to this value can't accept the specified unit or the string value, the
value will be unchanged and a DOMException will be raised.
Note: This method was part of an attempt to create a typed CSS Object Model. This attempt has been abandoned, and most browsers do not implement it.
To achieve your purpose, you can use:
- the untyped CSS Object Model, widely supported, or
- the modern CSS Typed Object Model API, less supported and considered experimental.
Syntax
setStringValue(stringType, stringValue)
Parameters
stringType-
An
unsigned shortrepresenting the type of the value. Possible values are: stringValue-
A string representing the new string value.
Return value
None (undefined).
Exceptions
InvalidAccessErrorDOMException-
Thrown if the CSS value doesn't contain a string value or if the string value can't be converted into the specified unit.
NoModificationAllowedErrorDOMException-
Thrown if the property is read-only.
Specifications
This feature was originally defined in the DOM Style Level 2 specification, but has been dropped from any standardization effort since then.
It has been superseded by a modern, but incompatible, CSS Typed Object Model API that is now on the standard track.