W3cubDocs

/DOM

CSSPrimitiveValue.setStringValue

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

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support No ? ? — 62 ? No ?
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support ? ? ? ? — 62 ? ? ?

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CSSPrimitiveValue/setStringValue