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

Specification Status Comment
Document Object Model (DOM) Level 2 Style Specification
The definition of 'CSSPrimitiveValue.setStringValue' in that specification.
Obsolete Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No ? Yes ? No ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support ? ? ? Yes ? ? ?

Document Tags and Contributors

Contributors to this page: fscholz, Sebastianz
Last updated by: fscholz,