Spec-Zone.ru › OpenJDK 25

Интерфейс CSSPrimitiveValue

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

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

См. также спецификацию Document Object Model (DOM) Level 2 Style.

Начиная с:
1.4, DOM Level 2

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

Модификатор и тип Поле Описание
static final short CSS_ATTR
Значение представляет собой функцию атрибута.
static final short CSS_CM
Значение представляет собой длину (см).
static final short CSS_COUNTER
Значение представляет собой функцию counter или counters.
static final short CSS_DEG
Значение представляет собой угол (градусы).
static final short CSS_DIMENSION
Значение представляет собой число с неизвестной размерностью.
static final short CSS_EMS
Значение представляет собой длину (em).
static final short CSS_EXS
Значение представляет собой длину (ex).
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
Значение представляет собой длину (пиксели).
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.

Поля, объявленные в интерфейсе CSSValue

CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST

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

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

Методы, объявленные в интерфейсе 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
Значение представляет собой длину (em). Значение можно получить с помощью метода getFloatValue.
См. также:
  • Значения констант полей

CSS_EXS

static final short CSS_EXS
Значение представляет собой длину (ex). Значение можно получить с помощью метода getFloatValue.
См. также:
  • Значения констант полей

CSS_PX

static final short CSS_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
Значение представляет собой длину (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
Значение представляет собой функцию counter или counters. Значение можно получить с помощью метода 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
Метод для задания значения типа float в указанной единице измерения. Если свойство, связанное с этим значением, не может принимать указанную единицу измерения или значение типа float, значение останется неизменным и будет вызвано исключение DOMException.
Параметры:
unitType — код единицы измерения, определенный выше. Код единицы измерения может обозначать только единицу измерения типа float (т. е. 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 — новое значение типа float.
Вызывает:
DOMException — INVALID_ACCESS_ERR: возникает, если связанное свойство не поддерживает значение типа float или тип единицы измерения.
NO_MODIFICATION_ALLOWED_ERR: возникает, если это свойство доступно только для чтения.

getFloatValue

float getFloatValue(short unitType) throws DOMException
Этот метод используется для получения значения типа float в указанной единице измерения. Если это значение CSS не содержит значения типа float или его нельзя преобразовать в указанную единицу измерения, возникает исключение DOMException.
Параметры:
unitType — код единицы измерения для получения значения типа float. Код единицы измерения может обозначать только единицу измерения типа float (т. е. 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).
Возвращает:
Значение типа float в указанной единице измерения.
Вызывает:
DOMException — INVALID_ACCESS_ERR: возникает, если значение CSS не содержит значения типа float или если это значение нельзя преобразовать в указанную единицу измерения.

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
Этот метод используется для получения значения Counter. Если это значение CSS не содержит значения счетчика, возникает исключение DOMException. Изменить соответствующее свойство стиля можно с помощью интерфейса Counter.
Возвращает:
Значение Counter.
Вызывает:
DOMException — INVALID_ACCESS_ERR: возникает, если значение CSS не содержит значения Counter (например, если это не 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).

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API