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.
Syntax
cssPrimitiveValue.setStringValue(stringType, stringValue);
Parameters
- stringType
- An
unsigned short
representing the type of the value. Possible values are:Constant Description CSS_ATTR
The value is an attr()
function.CSS_IDENT
The value is an identifier. CSS_STRING
The value is a <string>
.CSS_URI
The value is a <uri>
. - stringValue
- A
DOMString
representing the new string value.
Return value
Void.
Exceptions
Type | Description |
---|---|
DOMException
|
An INVALID_ACCESS_ERR is raised if the CSS value doesn't contain a string value or if the string value can't be converted into the specified unit.
An NO_MODIFICATION_ALLOWED_ERR is raised if this property is read-only. |
Specifications
Specification | Status | Comment |
Document Object Model (DOM) Level 2 Style SpecificationThe definition of 'CSSPrimitiveValue.setStringValue' in that specification. | Obsolete | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
No support No |
Edge
No support No |
Firefox
No support ? — 62 |
IE
No support No |
Opera
No support No |
Safari
? |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support 4 — 62 |
Opera Android
? |
Safari iOS
? |
Samsung Internet Android
No support No |
Legend
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Deprecated. Not for use in new websites.'
- Deprecated. Not for use in new websites.
CSSPrimitiveValue.setStringValue() by Mozilla Contributors is licensed under CC-BY-SA 2.5.