大网数据广告活动
Web 标准与前端开发

CSSPrimitiveValue: setFloatValue() method

· 52CE 我爱测

The **`setFloatValue()`** method of the CSSPrimitiveValue interface is used to set a float value. If the property attached to this value can't accept the specified unit or the float value, the value will be unchanged and a DOMException will be raised.

CSSOM

The setFloatValue() method of the CSSPrimitiveValue interface is used to set a float value. If the property attached to this value can't accept the specified unit or the float value, the value will be unchanged and a DOMException will be raised.

[!NOTE] This method was part of an attempt to create a typed CSS Object Model. This attempt has been abandoned, and most browsers do not implement it.

To achieve your purpose, you can use:

Syntax

setFloatValue(unitType, floatValue)

Parameters

  • unitType

    • : An unsigned short representing the code for the unit type, in which the value should be returned. Valid values are:

      Constant Description
      CSS_CM The value is a <length> in centimeters.
      CSS_DEG The value is an <angle> in degrees.
      CSS_DIMENSION The value is a <number> with an unknown dimension.
      CSS_EMS The value is a <length> in em units.
      CSS_EXS The value is a <length> in ex units.
      CSS_GRAD The value is an <angle> in grads.
      CSS_HZ The value is a <frequency> in Hertz. The value can be obtained by using the getFloatValue method.
      CSS_IN The value is a <length> in inches.
      CSS_KHZ The value is a <frequency> in Kilohertz.
      CSS_MM The value is a <length> in millimeters.
      CSS_MS The value is a <time> in milliseconds.
      CSS_NUMBER The value is a simple <number>.
      CSS_PC The value is a <length> in picas.
      CSS_PERCENTAGE The value is a <percentage>.
      CSS_PT The value is a <length> in points.
      CSS_PX The value is a <length> in pixels.
      CSS_RAD The value is an <angle> in radians.
      CSS_S The value is a <time> in seconds.
  • floatValue

    • : A float representing the new float value.

Return value

None (undefined).

Exceptions

<table class="no-markdown"> <thead> <tr> <th scope="col"><strong>Type</strong></th> <th scope="col"><strong>Description</strong></th> </tr> </thead> <tbody> <tr> <td><code>DOMException</code></td> <td> An <code>INVALID_ACCESS_ERR</code> is raised if the CSS value doesn't contain a float value or if the string value can't be converted into the specified unit.<br />A NO_MODIFICATION_ALLOWED_ERR is raised if this property is read-only. </td> </tr> </tbody> </table>

Specifications

This feature was originally defined in the DOM Style Level 2 specification, but has been dropped from any standardization effort since then.

It has been superseded by a modern, but incompatible, CSS Typed Object Model API that is now on the standard track.

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。