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 shortrepresenting the type of the value. Possible values are:Constant Description CSS_ATTRThe value is an attr()function.CSS_IDENTThe value is an identifier. CSS_STRINGThe value is a <string>.CSS_URIThe value is a <uri>. - stringValue
- A
DOMStringrepresenting 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
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | No support | (Yes) | ? | No support | ? |
| Feature | Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | (Yes) | ? | ? | ? | ? |
Document Tags and Contributors
Tags:
Contributors to this page:
Sebastianz
Last updated by:
Sebastianz,