CSSPrimitiveValue：setStringValue() 方法

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

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

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

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

语法

setStringValue(stringType, stringValue)

一个 unsigned short，表示值的类型。可能的值包括：

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

无（undefined）。

InvalidAccessError DOMException: 如果 CSS 值不包含字符串值，或者字符串值无法转换为指定的单位，则抛出此异常。
NoModificationAllowedError DOMException: 如果属性是只读的，则抛出此异常。

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

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

此页面最后修改于 2025年6月23日，由 MDN 贡献者修改。