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

CSSPrimitiveValue: getFloatValue() method

· 52CE 我爱测

The **`getFloatValue()`** method of the CSSPrimitiveValue interface is used to get a float value in a specified unit. If this CSS value doesn't contain a float value or can't be converted into the specified unit, a DOMException is raised.

CSSOM

The getFloatValue() method of the CSSPrimitiveValue interface is used to get a float value in a specified unit. If this CSS value doesn't contain a float value or can't be converted into the specified unit, a DOMException is 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

getFloatValue(unit)

Parameters

  • unit
    • : 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.

Return value

A float value in the specified unit.

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 float value can't be converted into the specified unit. </td> </tr> </tbody> </table>

Examples

const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("margin-top");
console.log(cssValue.getFloatValue(CSSPrimitiveValue.CSS_CM));

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

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

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