当前位置：文江博客知识库 en-US 文档 Web API CSSPrimitiveValue setStringValue

CSSPrimitiveValue.setStringValue() - Web APIs 编辑

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