CSSPrimitiveValue:setStringValue() 方法
已弃用:此功能不再推荐。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除的过程中,或者可能仅出于兼容性目的而保留。避免使用它,并在可能的情况下更新现有代码;请参阅此页面底部的兼容性表,以指导您的决策。请注意,此功能可能随时停止工作。
setStringValue()
是CSSPrimitiveValue
接口的方法,用于设置字符串值。如果附加到此值的属性无法接受指定的单位或字符串值,则该值将保持不变,并且会引发DOMException
。
注意:此方法是创建类型化 CSS 对象模型尝试的一部分。此尝试已被放弃,大多数浏览器都没有实现它。
为了达到您的目的,您可以使用
- 广泛支持的无类型CSS 对象模型,或
- 现代的CSS 类型化对象模型 API,支持度较低且被认为是实验性的。
语法
js
setStringValue(stringType, stringValue)
参数
stringType
-
表示值类型的
unsigned short
。可能的值为 stringValue
-
表示新字符串值的字符串。
返回值
无(undefined
)。
异常
InvalidAccessError
DOMException
-
如果 CSS 值不包含字符串值或字符串值无法转换为指定的单位,则抛出此异常。
- `NoModificationAllowedError'
DOMException
-
如果属性为只读,则抛出此异常。
规范
此功能最初在DOM 样式级别 2规范中定义,但此后已从任何标准化工作中删除。
它已被现代但不兼容的CSS 类型化对象模型 API取代,该 API 现已成为标准。
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。