CSSPrimitiveValue: setFloatValue() 方法

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

CSSPrimitiveValue 接口的 setFloatValue() 方法用于设置一个浮点数值。如果附加到此值的属性无法接受指定的单位或浮点数值，则该值将保持不变，并会引发一个 DOMException。

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

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

语法

setFloatValue(unitType, floatValue)

一个 unsigned short，表示返回值的单位类型代码。有效值为：

常量	描述
`CSS_CM`	该值是厘米（centimeters）中的 `<length>`。
`CSS_DEG`	该值是度（degrees）中的 `<angle>`。
`CSS_DIMENSION`	该值是未知维度的 `<number>`。
`CSS_EMS`	该值是 em 单位中的 `<length>`。
`CSS_EXS`	该值是 ex 单位中的 `<length>`。
`CSS_GRAD`	该值是 grad 单位中的 `<angle>`。
`CSS_HZ`	值为以 Hertz 为单位的 `<frequency>`。可以通过 getFloatValue 方法获取值。
`CSS_IN`	该值是英寸（inches）中的 `<length>`。
`CSS_KHZ`	该值是千赫（Kilohertz）中的 `<frequency>`。
`CSS_MM`	该值是毫米（millimeters）中的 `<length>`。
`CSS_MS`	该值是毫秒（milliseconds）中的 `<time>`。
`CSS_NUMBER`	该值是一个简单的 `<number>`。
`CSS_PC`	该值是 pica 中的 `<length>`。
`CSS_PERCENTAGE`	该值是一个 `<percentage>`。
`CSS_PT`	该值是 point 中的 `<length>`。
`CSS_PX`	该值是像素（pixels）中的 `<length>`。
`CSS_RAD`	该值是弧度（radians）中的 `<angle>`。
`CSS_S`	该值是秒（seconds）中的 `<time>`。

一个 float，表示新的浮点数值。

无（undefined）。

类型	描述
`DOMException`	如果 CSS 值不包含浮点数值，或者字符串值无法转换为指定的单位，则会引发 `INVALID_ACCESS_ERR`。如果此属性是只读的，则会引发 `NO_MODIFICATION_ALLOWED_ERR`。

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

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

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