Интерфейс CSSPrimitiveValue

Все суперинтерфейсы:: CSSValue

public interface CSSPrimitiveValue extends CSSValue

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

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

См. также Спецификацию уровня 2 DOM (Document Object Model) Style.

С:: 1.4, DOM Level 2

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final short`	`CSS_ATTR`	Значение — функция атрибута.
`static final short`	`CSS_CM`	Значение — длина (см).
`static final short`	`CSS_COUNTER`	Значение — функция счётчика или счётчиков.
`static final short`	`CSS_DEG`	Значение — угол (град).
`static final short`	`CSS_DIMENSION`	Значение — число с неизвестной размерностью.
`static final short`	`CSS_EMS`	Значение — длина (ems).
`static final short`	`CSS_EXS`	Значение — длина (exs).
`static final short`	`CSS_GRAD`	Значение — угол (град).
`static final short`	`CSS_HZ`	Значение — частота (Гц).
`static final short`	`CSS_IDENT`	Значение — идентификатор.
`static final short`	`CSS_IN`	Значение — длина (дюйм).
`static final short`	`CSS_KHZ`	Значение — частота (кГц).
`static final short`	`CSS_MM`	Значение — длина (мм).
`static final short`	`CSS_MS`	Значение — время (мс).
`static final short`	`CSS_NUMBER`	Значение — простое число.
`static final short`	`CSS_PC`	Значение — длина (pc).
`static final short`	`CSS_PERCENTAGE`	Значение — процент.
`static final short`	`CSS_PT`	Значение — длина (pt).
`static final short`	`CSS_PX`	Значение — длина (px).
`static final short`	`CSS_RAD`	Значение — угол (рад).
`static final short`	`CSS_RECT`	Значение — функция прямоугольника.
`static final short`	`CSS_RGBCOLOR`	Значение — цвет RGB.
`static final short`	`CSS_S`	Значение — время (с).
`static final short`	`CSS_STRING`	Значение — СТРОКА.
`static final short`	`CSS_UNKNOWN`	Значение — не распознанное значение CSS2.
`static final short`	`CSS_URI`	Значение — URI.

Поля, объявленные в интерфейсе org.w3c.dom.css.CSSValue

CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST

Краткое описание методов

Модификатор и тип	Метод	Описание
`Counter`	`getCounterValue()`	Этот метод используется для получения значения счётчика.
`float`	`getFloatValue(short unitType)`	Этот метод используется для получения числового значения в заданном формате.
`short`	`getPrimitiveType()`	Тип значения, как определено в вышеуказанных константах.
`Rect`	`getRectValue()`	Этот метод используется для получения значения прямоугольника.
`RGBColor`	`getRGBColorValue()`	Этот метод используется для получения цвета RGB.
`String`	`getStringValue()`	Этот метод используется для получения строкового значения.
`void`	`setFloatValue(short unitType, float floatValue)`	Метод для задания числового значения с указанным форматом.
`void`	`setStringValue(short stringType, String stringValue)`	Метод для задания строкового значения с указанным форматом.

Методы, объявленные в интерфейсе org.w3c.dom.css.CSSValue

getCssText, getCssValueType, setCssText

END_OF_DOCUMENT_MARKER

Подробное описание полей

CSS_UNKNOWN

static final short CSS_UNKNOWN

Значение не является распознаваемым значением CSS2. Значение можно получить только с помощью атрибута cssText.

См. также:

CSS_NUMBER

static final short CSS_NUMBER

Значение представляет собой простое число. Значение можно получить, используя метод getFloatValue.

См. также:

CSS_PERCENTAGE

static final short CSS_PERCENTAGE

Значение представляет собой процент. Значение можно получить, используя метод getFloatValue.

См. также:

CSS_EMS

static final short CSS_EMS

Значение представляет собой длину (ems). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_EXS

static final short CSS_EXS

Значение представляет собой длину (exs). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_PX

static final short CSS_PX

Значение представляет собой длину (px). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_CM

static final short CSS_CM

Значение представляет собой длину (см). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_MM

static final short CSS_MM

Значение представляет собой длину (мм). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_IN

static final short CSS_IN

Значение представляет собой длину (дюйм). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_PT

static final short CSS_PT

Значение представляет собой длину (pt). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_PC

static final short CSS_PC

Значение представляет собой длину (pc). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_DEG

static final short CSS_DEG

Значение представляет собой угол (град). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_RAD

static final short CSS_RAD

Значение представляет собой угол (рад). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_GRAD

static final short CSS_GRAD

Значение представляет собой угол (град). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_MS

static final short CSS_MS

Значение представляет собой время (мс). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_S

static final short CSS_S

Значение представляет собой время (с). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_HZ

static final short CSS_HZ

Значение представляет собой частоту (Гц). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_KHZ

static final short CSS_KHZ

Значение представляет собой частоту (кГц). Значение можно получить, используя метод getFloatValue.

См. также:

CSS_DIMENSION

static final short CSS_DIMENSION

Значение представляет собой число с неизвестной размерностью. Значение можно получить, используя метод getFloatValue.

См. также:

CSS_STRING

static final short CSS_STRING

Значение представляет собой строку. Значение можно получить, используя метод getStringValue.

См. также:

CSS_URI

static final short CSS_URI

Значение представляет собой URI. Значение можно получить, используя метод getStringValue.

См. также:

CSS_IDENT

static final short CSS_IDENT

Значение представляет собой идентификатор. Значение можно получить, используя метод getStringValue.

См. также:

CSS_ATTR

static final short CSS_ATTR

Значение представляет собой функцию атрибута. Значение можно получить, используя метод getStringValue.

См. также:

CSS_COUNTER

static final short CSS_COUNTER

Значение — функция счётчика или счётчиков. Значение можно получить, используя метод getCounterValue.

См. также:

CSS_RECT

static final short CSS_RECT

Значение — функция rect. Значение можно получить, используя метод getRectValue.

См. также:

CSS_RGBCOLOR

static final short CSS_RGBCOLOR

Значение — цвет RGB. Значение можно получить, используя метод getRGBColorValue.

См. также:

Подробное описание методов

getPrimitiveType

short getPrimitiveType()

Тип значения, определённый константами, указанными выше.

setFloatValue

void setFloatValue(short unitType, float floatValue) throws DOMException

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

Параметры:: unitType - Код типа единицы измерения, как определено выше. Код типа единицы измерения может быть только типом единицы измерения с плавающей точкой (например, CSS_NUMBER, CSS_PERCENTAGE, CSS_EMS, CSS_EXS, CSS_PX, CSS_CM, CSS_MM, CSS_IN, CSS_PT, CSS_PC, CSS_DEG, CSS_RAD, CSS_GRAD, CSS_MS, CSS_S, CSS_HZ, CSS_KHZ, CSS_DIMENSION).; floatValue - Новое значение с плавающей точкой.
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если прикреплённое свойство не поддерживает значение с плавающей точкой или тип единицы измерения.
NO_MODIFICATION_ALLOWED_ERR: Возбуждается, если это свойство только для чтения.

getFloatValue

float getFloatValue(short unitType) throws DOMException

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

Параметры:: unitType - Код типа единицы измерения для получения значения с плавающей точкой. Код типа единицы измерения может быть только типом единицы измерения с плавающей точкой (например, CSS_NUMBER, CSS_PERCENTAGE, CSS_EMS, CSS_EXS, CSS_PX, CSS_CM, CSS_MM, CSS_IN, CSS_PT, CSS_PC, CSS_DEG, CSS_RAD, CSS_GRAD, CSS_MS, CSS_S, CSS_HZ, CSS_KHZ, CSS_DIMENSION).
Возвращает:: Значение с плавающей точкой в указанном типе единицы измерения.
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если значение CSS не содержит значение с плавающей точкой или значение с плавающей точкой не может быть преобразовано в указанный тип единицы измерения.

setStringValue

void setStringValue(short stringType, String stringValue) throws DOMException

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

Параметры:: stringType - Код строкового типа единицы измерения, как определено выше. Код строкового типа единицы измерения может быть только типом строковой единицы измерения (например, CSS_STRING, CSS_URI, CSS_IDENT и CSS_ATTR).; stringValue - Новое строковое значение.
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если значение CSS не содержит строковое значение или строковое значение не может быть преобразовано в указанный тип единицы измерения.
NO_MODIFICATION_ALLOWED_ERR: Возбуждается, если это свойство только для чтения.

getStringValue

String getStringValue() throws DOMException

Этот метод используется для получения строкового значения. Если значение CSS не содержит строковое значение, возбуждается исключение DOMException. Некоторые свойства (например, 'font-family' или 'voice-family') преобразуют список идентификаторов, разделённых пробелами, в строку.

Возвращает:: Строковое значение в текущем типе единицы измерения. Текущий primitiveType может быть только типом строковой единицы измерения (например, CSS_STRING, CSS_URI, CSS_IDENT и CSS_ATTR).
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если значение CSS не содержит строковое значение.

getCounterValue

Counter getCounterValue() throws DOMException

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

Возвращает:: Значение счётчика.
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если значение CSS не содержит значения счётчика (например, это не CSS_COUNTER).

getRectValue

Rect getRectValue() throws DOMException

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

Возвращает:: Значение Rect.
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если значение CSS не содержит значение Rect. (например, это не CSS_RECT).

getRGBColorValue

RGBColor getRGBColorValue() throws DOMException

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

Возвращает:: значение цвета RGB.
Исключения:: DOMException - INVALID_ACCESS_ERR: Возбуждается, если прикреплённое свойство не может вернуть значение цвета RGB (например, это не CSS_RGBCOLOR).

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.xml.dom/org/w3c/dom/css/CSSPrimitiveValue.html