Javascript [Electronic resources] : The Definitive Guide (4th Edition) نسخه متنی

Availability

DOM Level 2 CSS

Inherits from/Overrides

CSSValue CSSPrimitiveValue

Constants

The following constants are
the legal values for the primitiveType property.
They specify the type of the value and, for numeric values, the units
in which the value is represented.

unsigned short CSS_UNKNOWN = 0

The value is not recognized, and the implementation does not know how
to parse it. The textual representation of the value is available
through the cssText property.

unsigned short CSS_NUMBER = 1

A unitless number. Query with getFloatValue( ).

unsigned short CSS_PERCENTAGE = 2

A percentage. Query with getFloatValue( ).

unsigned short CSS_EMS = 3

A relative length measured in ems (the height of the current font).
Query with getFloatValue( ).

unsigned short CSS_EXS = 4

A relative length measured in exs (the "x-height" of the
current font). Query with getFloatValue( ).

unsigned short CSS_PX = 5

A length measured in pixels. Query with getFloatValue(
). Pixel lengths are relative measurements, in the sense
that their size depends on the display resolution, and they cannot be
converted to inches, millimeters, points, or other absolute lengths.
However, pixels are also one of the most commonly used units, and
they are treated as absolute values for the purposes of
AbstractView.getComputedStyle( ), for example.

unsigned short CSS_CM = 6

An absolute length measured in centimeters. Query with
getFloatValue( ).

unsigned short CSS_MM = 7

An absolute length measured in millimeters. Query with
getFloatValue( ).

unsigned short CSS_IN = 8

An absolute length measured in inches. Query with
getFloatValue( ).

unsigned short CSS_PT = 9

An absolute length measured in points (1/72 of an inch). Query with
getFloatValue( ).

unsigned short CSS_PC = 10

An absolute length measured in picas (12 points). Query with
getFloatValue( ).

unsigned short CSS_DEG = 11

An angle measured in degrees. Query with getFloatValue(
).

unsigned short CSS_RAD = 12

An angle measured in radians. Query with getFloatValue(
).

unsigned short CSS_GRAD = 13

An angle measured in grads. Query with getFloatValue(
).

unsigned short CSS_MS = 14

A time measured in milliseconds. Query with getFloatValue(
).

unsigned short CSS_S = 15

A time measured in seconds. Query with getFloatValue(
).

unsigned short CSS_HZ = 16

A frequency measured in hertz. Query with getFloatValue(
).

unsigned short CSS_KHZ = 17

A frequency measured in kilohertz. Query with getFloatValue(
).

unsigned short CSS_DIMENSION = 18

A unitless dimension. Query with getFloatValue( ).

unsigned short CSS_STRING = 19

A string. Query with getStringValue( ).

unsigned short CSS_URI = 20

A URI. Query with getStringValue( ).

unsigned short CSS_IDENT = 21

An identifier. Query with getStringValue( ).

unsigned short CSS_ATTR = 22

An attribute function. Query with getStringValue(
).

unsigned short CSS_COUNTER = 23

A counter. Query with getCounterValue( ).

unsigned short CSS_RECT = 24

A rectangle. Query with getRectValue( ).

unsigned short CSS_RGBCOLOR = 25

A color. Query with getRGBColorValue( ).

Properties

readonly unsigned short primitiveType

The
type of this value. This property holds one of the constants defined
in the previous section.

Methods

getCounterValue( )

For values of type CSS_COUNTER, returns the
Counter object that represents the value.

getFloatValue( )

Returns a numeric value, converting it, if necessary, to the
specified units.

getRectValue( )

For values of type CSS_RECT, returns the Rect
object that represents the value.

getRGBColorValue( )

For values of type CSS_RGBCOLOR, returns the
RGBColor object that represents the value.

getStringValue( )

Returns the value as a string.

setFloatValue( )

Sets a numeric value to the specified number of the specified units.

setStringValue( )

Sets a string value to the specified string of the specified type.

Description

This subinterface of CSSValue represents a single CSS value. Contrast
it with the CSSValueList interface, which represents a list of CSS
values. The word "primitive" in the name of this
interface is misleading; this interface can represent some complex
types of CSS values, such as counters, rectangles, and colors.

The primitiveType property holds one of the
previously defined constants and specifies the type of the value. The
various methods defined by this interface allow you to query values
of various types and also to set numeric and string values.

See Also

Counter, CSSValue, CSSValueList, Rect, RGBColor

Type of

RGBColor.blue, RGBColor.green, RGBColor.red, Rect.bottom, Rect.left,
Rect.right, Rect.top