CSSPrimitiveValue:setStringValue() 方法
已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。
CSSPrimitiveValue
接口的 setStringValue()
方法用于设置字符串值。如果此值关联的属性无法接受指定的单位或字符串值,则该值将保持不变,并会抛出 DOMException
。
注意:此方法是创建类型化 CSS 对象模型(Typed CSS Object Model)尝试的一部分。该尝试已被放弃,大多数浏览器并未实现它。
要实现您的目的,您可以使用
- 广泛支持的非类型化
CSS 对象模型
,或 - 较少支持且被视为实验性的现代
CSS 类型化对象模型 API
。
语法
js
setStringValue(stringType, stringValue)
参数
stringType
-
一个
unsigned short
,表示值的类型。可能的值包括: stringValue
-
表示新字符串值的字符串。
返回值
无(undefined
)。
异常
InvalidAccessError
DOMException
-
如果 CSS 值不包含字符串值,或者字符串值无法转换为指定的单位,则抛出此异常。
NoModificationAllowedError
DOMException
-
如果属性是只读的,则抛出此异常。
规范
此功能最初定义在 DOM Style Level 2 规范中,但此后已从任何标准化工作中删除。
它已被现代但不兼容的 CSS 类型化对象模型 API 所取代,该 API 现在已处于标准轨道。
浏览器兼容性
加载中…