CSSPrimitiveValue: setFloatValue() 方法
已弃用:此功能不再推荐。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,如果可能,更新现有代码;请参阅此页面底部的兼容性表以指导您的决策。请注意,此功能可能随时停止工作。
setFloatValue()
是 CSSPrimitiveValue
接口的方法,用于设置浮点值。如果附加到此值的属性无法接受指定的单位或浮点值,则该值将保持不变,并且会引发 DOMException
。
注意:此方法是创建类型化 CSS 对象模型的尝试的一部分。此尝试已被放弃,大多数浏览器都没有实现它。
要实现您的目的,您可以使用
- 广泛支持的非类型化 CSS 对象模型,或
- 支持较少且被视为实验性的现代 CSS 类型化对象模型 API。
语法
js
setFloatValue(unitType, floatValue)
参数
unitType
-
一个表示单位类型代码的
unsigned short
,其中应返回该值。有效值为常量 描述 CSS_CM
该值为以厘米为单位的 <length>
。CSS_DEG
该值为以度为单位的 <angle>
。CSS_DIMENSION
该值为具有未知维度的 <number>
。CSS_EMS
该值为以 em 为单位的 <length>
。CSS_EXS
该值为以 ex 为单位的 <length>
。CSS_GRAD
该值为以 grad 为单位的 <angle>
。CSS_HZ
该值为以赫兹为单位的 <frequency>
。可以使用 getFloatValue 方法获取该值。CSS_IN
该值为以英寸为单位的 <length>
。CSS_KHZ
该值为以千赫兹为单位的 <frequency>
。CSS_MM
该值为以毫米为单位的 <length>
。CSS_MS
该值为以毫秒为单位的 <time>
。CSS_NUMBER
该值为简单的 <number>
。CSS_PC
该值为以 pica 为单位的 <length>
。CSS_PERCENTAGE
该值为 <percentage>
。CSS_PT
该值为以磅为单位的 <length>
。CSS_PX
该值为以像素为单位的 <length>
。CSS_RAD
该值为以弧度为单位的 <angle>
。CSS_S
该值为以秒为单位的 <time>
。 floatValue
-
一个表示新浮点值的
float
。
返回值
无 (undefined
).
异常
类型 | 描述 |
---|---|
DOMException |
如果 CSS 值不包含浮点值,或者字符串值无法转换为指定的单位,则会引发INVALID_ACCESS_ERR 。如果此属性为只读,则会引发 NO_MODIFICATION_ALLOWED_ERR。 |
规范
此功能最初在 DOM 样式级别 2 规范中定义,但此后已从任何标准化工作中删除。
它已被现代但不兼容的 CSS 类型化对象模型 API 取代,该 API 现在已成为标准轨道。
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。