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.	Recommendation	Initial definition

Browser compatibility