Интерфейс 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`	Значение — длина (пт).
`static final short`	`CSS_PX`	Значение — длина (px).
`static final short`	`CSS_RAD`	Значение — угол (рад).
`static final short`	`CSS_RECT`	Значение — функция 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()`	Этот метод используется для получения значения rect.
`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

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

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

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

См. также:

Значения постоянных полей

CSS_PC

static final short CSS_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

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

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

getRGBColorValue

RGBColor getRGBColorValue() throws DOMException

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

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

© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/jdk.xml.dom/org/w3c/dom/css/CSSPrimitiveValue.html