Spec-Zone.ru › OpenJDK 21

Интерфейс 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
Значение — длина (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, 2023, 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/21/docs/api/jdk.xml.dom/org/w3c/dom/css/CSSPrimitiveValue.html

Spec-Zone.ru

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