Spec-Zone.ru › OpenJDK 27

Интерфейс CSSPrimitiveValue

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

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

См. также спецификацию модели объектного документа (DOM) уровня 2: стили.

Начиная с:
1.4, DOM уровня 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
Значение представляет собой длину (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
Значение представляет собой функцию 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
Модификатор и тип Поле Описание
static final short CSS_CUSTOM
Значение представляет собой пользовательское значение.
static final short CSS_INHERIT
Значение унаследовано, а cssText содержит «inherit».
static final short CSS_PRIMITIVE_VALUE
Значение является примитивным, и экземпляр интерфейса CSSPrimitiveValue можно получить с помощью методов приведения типов, специфичных для привязки, применённых к этому экземпляру интерфейса CSSValue.
static final short CSS_VALUE_LIST
Значение представляет собой список CSSValue, и экземпляр интерфейса CSSValueList можно получить с помощью методов приведения типов, специфичных для привязки, применённых к этому экземпляру интерфейса CSSValue.

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

Модификатор и тип Метод Описание
Counter getCounterValue()
Этот метод используется для получения значения Counter.
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)
Метод для задания строкового значения с указанием единицы измерения.

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

getCssText, getCssValueType, setCssText
Модификатор и тип Метод Описание
String getCssText()
Строковое представление текущего значения.
short getCssValueType()
Код, определяющий тип значения, как указано выше.
void setCssText(String cssText)
Строковое представление текущего значения.

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

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
Значение представляет собой функцию 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
Метод для задания значения с плавающей точкой с указанием единицы измерения. Если свойство, связанное с этим значением, не поддерживает указанную единицу измерения или значение с плавающей точкой, значение не изменится и будет выброшено исключение 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
Этот метод используется для получения значения 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, 2026, 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.

Spec-Zone.ru

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