CSSPrimitiveValue

Интерфейс CSSPrimitiveValue наследуется от интерфейса CSSValue и представляет текущее вычисленное значение свойства CSS.

Этот интерфейс представляет одно значение CSS. Он может использоваться для определения значения конкретного свойства стиля, установленного в блоке, или для явного задания конкретного свойства стиля в блоке. Экземпляр этого интерфейса можно получить из метода getPropertyCSSValue() интерфейса CSSStyleDeclaration. Объект CSSPrimitiveValue появляется только в контексте свойства CSS.

Преобразования разрешены между абсолютными значениями (от миллиметров до сантиметров, от градусов до радиан и т. д.), но не между относительными значениями. (Например, значение в пикселях нельзя преобразовать в значение в сантиметрах.) Значения в процентах не могут быть преобразованы, так как они относительны к родительскому значению (или другому значению свойства). Есть одно исключение для значений цвета в процентах: поскольку значение цвета в процентах относительно диапазона 0-255, значение цвета в процентах можно преобразовать в число (см. также интерфейс RGBColor).

Наследует свойства от родителя, CSSValue.

CSSPrimitiveValue.primitiveType Только для чтения Устаревшее

Значение unsigned short, представляющее тип значения. Возможные значения:

Постоянная	Описание
CSS_ATTR	Значение — функция attr(). Значение можно получить, используя метод getStringValue().
CSS_CM	Значение — <length> в сантиметрах. Значение можно получить, используя метод getFloatValue().
CSS_COUNTER	Значение — функция счётчика или счётчиков. Значение можно получить, используя метод getCounterValue().
CSS_DEG	Значение — <angle> в градусах. Значение можно получить, используя метод getFloatValue().
CSS_DIMENSION	Значение — <number> с неизвестной размерностью. Значение можно получить, используя метод getFloatValue().
CSS_EMS	Значение — <length> в единицах em. Значение можно получить, используя метод getFloatValue().
CSS_EXS	Значение — <length> в единицах ex. Значение можно получить, используя метод getFloatValue().
CSS_GRAD	Значение — <angle> в градах. Значение можно получить, используя метод getFloatValue().
CSS_HZ	Значение — <frequency> в Герцах. Значение можно получить, используя метод getFloatValue.
CSS_IDENT	Значение — идентификатор. Значение можно получить, используя метод getStringValue().
CSS_IN	Значение — <length> в дюймах. Значение можно получить, используя метод getFloatValue().
CSS_KHZ	Значение — <frequency> в Килогерцах. Значение можно получить, используя метод getFloatValue().
CSS_MM	Значение — <length> в миллиметрах. Значение можно получить, используя метод getFloatValue().
CSS_MS	Значение — <time> в миллисекундах. Значение можно получить, используя метод getFloatValue().
CSS_NUMBER	Значение — простое <number>. Значение можно получить, используя метод getFloatValue().
CSS_PC	Значение — <length> в пиках. Значение можно получить, используя метод getFloatValue().
CSS_PERCENTAGE	Значение — <percentage>. Значение можно получить, используя метод getFloatValue().
CSS_PT	Значение — <length> в пунктах. Значение можно получить, используя метод getFloatValue().
CSS_PX	Значение — <length> в пикселях. Значение можно получить, используя метод getFloatValue().
CSS_RAD	Значение — <angle> в радианах. Значение можно получить, используя метод getFloatValue().
CSS_RECT	Значение — функция rect(). Значение можно получить, используя метод getRectValue().
CSS_RGBCOLOR	Значение — <color>. Значение можно получить, используя метод getRGBColorValue().
CSS_S	Значение — <time> в секундах. Значение можно получить, используя метод getFloatValue().
CSS_STRING	Значение — <string>. Значение можно получить, используя метод getStringValue().
CSS_UNKNOWN	Значение — не распознанное значение CSS2. Значение можно получить только используя атрибут cssText.
CSS_URI	Значение — <url>. Значение можно получить, используя метод getStringValue().

CSSPrimitiveValue.getCounterValue() Устаревший

Этот метод используется для получения значения счётчика. Если это значение CSS не содержит значения счётчика, возникает исключение DOMException. Изменение соответствующего свойства стиля можно выполнить с помощью интерфейса Counter.

CSSPrimitiveValue.getFloatValue() Устаревший

Этот метод используется для получения числового значения в указанной единице измерения. Если это значение CSS не содержит числового значения или не может быть преобразовано в указанную единицу измерения, возникает исключение DOMException.

CSSPrimitiveValue.getRGBColorValue() Устаревший

Этот метод используется для получения значения цвета RGB. Если это значение CSS не содержит значения цвета RGB, возникает исключение DOMException. Изменение соответствующего свойства стиля можно выполнить с помощью интерфейса RGBColor.

CSSPrimitiveValue.getRectValue() Устаревший

Этот метод используется для получения значения Rect. Если это значение CSS не содержит значения Rect, возникает исключение DOMException. Изменение соответствующего свойства стиля можно выполнить с помощью интерфейса Rect.

CSSPrimitiveValue.getStringValue() Устаревший

Этот метод используется для получения строкового значения. Если значение CSS не содержит строкового значения, возникает исключение DOMException.

CSSPrimitiveValue.setFloatValue() Устаревший

Метод для установки числового значения с указанной единицей измерения. Если свойство, связанное с этим значением, не может принять указанную единицу измерения или числовое значение, значение останется без изменений, и будет выброшено исключение DOMException.

CSSPrimitiveValue.setStringValue() Устаревший

Метод для установки строкового значения с указанной единицей измерения. Если свойство, связанное с этим значением, не может принять указанную единицу измерения или строковое значение, значение останется без изменений, и будет выброшено исключение DOMException.

Эта функция изначально была определена в спецификации DOM Style Level 2, но с тех пор исключена из любых стандартизирующих усилий.

Она была заменена современной, но несовместимой, CSS Typed Object Model API, которая теперь соответствует стандарту.

• CSSValue
• CSSValueList