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

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`setStringValue` Deprecated	Chrome No support No	Edge No support No	Firefox No support ? — 62	IE ?	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.