Интерфейс CSSPrimitiveValue

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

public interface CSSPrimitiveValue
extends CSSValue

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

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

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

С момента:: 1.4, DOM Level 2

Поля

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

Значение представляет собой длину (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

Этот метод используется для получения значения прямоугольника. Если это значение 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, 2020, 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/11/docs/api/jdk.xml.dom/org/w3c/dom/css/CSSPrimitiveValue.html