CSSPrimitiveValue: setStringValue() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("CSSOM")}}{{non-standard_header}}

The **setStringValue()** method of the {{domxref("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 {{domxref("DOMException")}} will be raised.

توجه: This method was part of an attempt to create a typed CSS Object Model. This attempt has been abandoned, and most browsers do not implement it. To achieve your purpose, you can use: - the untyped CSS Object Model, widely supported, or - the modern CSS Typed Object Model API, less supported and considered experimental.

Syntax

js-nolint
setStringValue(stringType, stringValue)

Parameters

  • stringType
  • : An unsigned short representing the type of the value. Possible values

are:

ConstantDescription
CSS_ATTRThe value is an {{cssxref("attr", "attr()")}} function.
CSS_IDENTThe value is an identifier.
CSS_STRINGThe value is a {{cssxref("<string>")}}.
CSS_URIThe value is a {{cssxref("url_value", "<url>")}}.
  • stringValue
  • : A string representing the new string value.

Return value

None ({{jsxref("undefined")}}).

Exceptions

  • InvalidAccessError {{domxref("DOMException")}}
  • : Thrown if the CSS value doesn't contain a string value

or if the string value can't be converted into the specified unit.

  • NoModificationAllowedError {{domxref("DOMException")}}
  • : Thrown if the property is read-only.

Specifications

This feature was originally defined in the DOM Style Level 2 specification, but has been dropped from any standardization effort since then.

It has been superseded by a modern, but incompatible, CSS Typed Object Model API that is now on the standard track.

Browser compatibility

{{Compat}}