Name
CSSPrimitiveValue.getFloatValue( ) — get a numeric value, possibly converting units
Availability
DOM Level 2 CSS
Synopsis
float getFloatValue(unsigned short unitType
)
throws DOMException;
Arguments
-
unitType
One of the CSSPrimitiveValue type constants that specifies the desired units for the returned value.
Returns
The floating-point numeric value of this CSSPrimitiveValue, expressed in the specified units.
Throws
This method throws a DOMException with a code
of
INVALID_ACCESS_ERR
if this CSSPrimitiveValue holds
a non-numeric value, or if the value cannot be converted to the
requested type of units. (See the next section for more about unit
conversion.)
Description
For CSSPrimitiveValue objects that hold numeric values, this method converts those values to the specified units and returns the converted values.
Only certain types of unit conversions are allowed. Lengths may be converted to lengths, angles to angles, times to times, and frequencies to frequencies. Obviously, however, a length measured in millimeters cannot be converted to a frequency measured in kilohertz. Also, not all lengths can be converted. Relative lengths (lengths measured in ems, exs, or pixels) can be converted to other relative lengths but cannot be converted to absolute lengths. Similarly, absolute lengths cannot be converted to relative lengths. Finally, percentage values cannot be converted to any other unit type, except for color percentage values, which express a percentage of 255 and can be converted to ...
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.