CSSPrimitiveValue:setStringValue() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

CSSPrimitiveValue 接口的 setStringValue() 方法用于设置字符串值。如果此值关联的属性无法接受指定的单位或字符串值,则该值将保持不变,并会抛出 DOMException

注意:此方法是创建类型化 CSS 对象模型(Typed CSS Object Model)尝试的一部分。该尝试已被放弃,大多数浏览器并未实现它。

要实现您的目的,您可以使用

语法

js
setStringValue(stringType, stringValue)

参数

stringType

一个 unsigned short,表示值的类型。可能的值包括:

常量 描述
CSS_ATTR 该值为一个 attr() 函数。
CSS_IDENT 该值为一个标识符。
CSS_STRING 该值为一个 <string>
CSS_URI 该值为一个 <url>
stringValue

表示新字符串值的字符串。

返回值

无(undefined)。

异常

InvalidAccessError DOMException

如果 CSS 值不包含字符串值,或者字符串值无法转换为指定的单位,则抛出此异常。

NoModificationAllowedError DOMException

如果属性是只读的,则抛出此异常。

规范

此功能最初定义在 DOM Style Level 2 规范中,但此后已从任何标准化工作中删除。

它已被现代但不兼容的 CSS 类型化对象模型 API 所取代,该 API 现在已处于标准轨道。

浏览器兼容性