CSSPrimitiveValue: setStringValue() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("CSSOM")}}{{non-standard_header}}
The **setStringValue()** method of the {{domxref("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 {{domxref("DOMException")}} will be raised.
توجه: 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:
| Constant | Description |
|---|---|
CSS_ATTR | The value is an {{cssxref("attr", "attr()")}} function. |
CSS_IDENT | The value is an identifier. |
CSS_STRING | The value is a {{cssxref("<string>")}}. |
CSS_URI | The value is a {{cssxref("url_value", "<url>")}}. |
stringValue- : A string representing the new string value.
Return value
None ({{jsxref("undefined")}}).
Exceptions
InvalidAccessError{{domxref("DOMException")}}- : Thrown if the CSS value doesn't contain a string value
or if the string value can't be converted into the specified unit.
NoModificationAllowedError{{domxref("DOMException")}}- : 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.
Browser compatibility
{{Compat}}