CSSPrimitiveValue:setStringValue() 方法

已弃用:此功能不再推荐。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除的过程中,或者可能仅出于兼容性目的而保留。避免使用它,并在可能的情况下更新现有代码;请参阅此页面底部的兼容性表,以指导您的决策。请注意,此功能可能随时停止工作。

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

注意:此方法是创建类型化 CSS 对象模型尝试的一部分。此尝试已被放弃,大多数浏览器都没有实现它。

为了达到您的目的,您可以使用

语法

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 样式级别 2规范中定义,但此后已从任何标准化工作中删除。

它已被现代但不兼容的CSS 类型化对象模型 API取代,该 API 现已成为标准。

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。