Интерфейс CSSStyleDeclaration

public interface CSSStyleDeclaration

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

Хотя реализация может не распознавать все свойства CSS в блоке объявления CSS, ожидается, что она предоставит доступ ко всем указанным свойствам в таблице стилей через интерфейс CSSStyleDeclaration. Кроме того, реализации, поддерживающие конкретный уровень CSS, должны правильно обрабатывать сокращённые свойства CSS для этого уровня. Для получения дополнительной информации о сокращённых свойствах см. интерфейс CSS2Properties.

Этот интерфейс также используется для предоставления только для чтения доступа к вычисленным значениям элемента. См. также интерфейс ViewCSS. Модель объектов CSS не предоставляет доступа к заданным или фактическим значениям каскада CSS.

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

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

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

Модификатор и тип	Метод	Описание
`String`	`getCssText()`	Обрабатываемое текстовое представление блока объявления (исключая окружающие фигурные скобки).
`int`	`getLength()`	Количество свойств, явно заданных в этом блоке объявления.
`CSSRule`	`getParentRule()`	Правило CSS, содержащее этот блок объявления, или `null`, если этот `CSSStyleDeclaration` не прикреплён к `CSSRule`.
`CSSValue`	`getPropertyCSSValue(String propertyName)`	Используется для получения объектного представления значения свойства CSS, если оно было явно задано в этом блоке объявления.
`String`	`getPropertyPriority(String propertyName)`	Используется для получения приоритета свойства CSS (например, квалификатора `"important"`), если приоритет был явно задан в этом блоке объявления.
`String`	`getPropertyValue(String propertyName)`	Используется для получения значения свойства CSS, если оно было явно задано в этом блоке объявления.
`String`	`item(int index)`	Используется для получения свойств, которые были явно заданы в этом блоке объявления.
`String`	`removeProperty(String propertyName)`	Используется для удаления свойства CSS, если оно было явно задано в этом блоке объявления.
`void`	`setCssText(String cssText)`	Обрабатываемое текстовое представление блока объявления (исключая окружающие фигурные скобки).
`void`	`setProperty(String propertyName, String value, String priority)`	Используется для задания значения и приоритета свойства в этом блоке объявления.

Подробное описание методов

getCssText

String getCssText()

Обрабатываемое текстовое представление блока объявления (исключая окружающие фигурные скобки). Установка этого атрибута приведёт к обработке нового значения и сбросу всех свойств в блоке объявления, включая удаление или добавление свойств.

setCssText

void setCssText(String cssText) throws DOMException

Выбрасывает:: DOMException - SYNTAX_ERR: Выбрасывается, если указанное значение CSS имеет синтаксическую ошибку и не может быть обработано.
NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если это объявление только для чтения или свойство только для чтения.

getPropertyValue

String getPropertyValue(String propertyName)

Используется для получения значения свойства CSS, если оно было явно задано в этом блоке объявления.

Параметры:: propertyName - Название свойства CSS. См. индекс свойств CSS.
Возвращает:: Возвращает значение свойства, если оно было явно задано для этого блока объявления. Возвращает пустую строку, если свойство не было задано.

getPropertyCSSValue

CSSValue getPropertyCSSValue(String propertyName)

Используется для получения объектного представления значения свойства CSS, если оно было явно задано в этом блоке объявления. Этот метод возвращает null, если свойство является сокращённым свойством. Значения сокращённых свойств могут быть получены и изменены только как строки, используя методы getPropertyValue и setProperty.

Параметры:: propertyName - Название свойства CSS. См. индекс свойств CSS.
Возвращает:: Возвращает значение свойства, если оно было явно задано для этого блока объявления. Возвращает null, если свойство не было задано.

removeProperty

String removeProperty(String propertyName) throws DOMException

Используется для удаления свойства CSS, если оно было явно задано в этом блоке объявления.

Параметры:: propertyName - Название свойства CSS. См. индекс свойств CSS.
Возвращает:: Возвращает значение свойства, если оно было явно задано для этого блока объявления. Возвращает пустую строку, если свойство не было задано или имя свойства не соответствует известному свойству CSS.
Выбрасывает:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если это объявление только для чтения или свойство только для чтения.

getPropertyPriority

String getPropertyPriority(String propertyName)

Используется для получения приоритета свойства CSS (например, квалификатора "important") если приоритет был явно задан в этом блоке объявления.

Параметры:: propertyName - Название свойства CSS. См. индекс свойств CSS.
Возвращает:: Строка, представляющая приоритет (например, "important") если свойство было явно задано в этом блоке объявления и имеет указанный приоритет. В противном случае пустая строка.

setProperty

void setProperty(String propertyName, String value, String priority) throws DOMException

Используется для задания значения и приоритета свойства в этом блоке объявления. setProperty позволяет изменять свойство или добавлять новое в блок объявления. Любой вызов этого метода может изменить порядок свойств в методе item.

Параметры:: propertyName - Название свойства CSS. См. индекс свойств CSS.; value - Новое значение свойства.; priority - Новый приоритет свойства (например, "important") или пустая строка, если приоритет отсутствует.
Выбрасывает:: DOMException - SYNTAX_ERR: Выбрасывается, если указанное значение имеет синтаксическую ошибку и не может быть обработано.
NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если это объявление только для чтения или свойство только для чтения.

getLength

int getLength()

Количество свойств, явно заданных в этом блоке объявления. Диапазон допустимых индексов от 0 до length-1 включительно.

item

String item(int index)

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

Параметры:: index - Индекс имени свойства для получения.
Возвращает:: Имя свойства в данной порядковой позиции. Пустая строка, если свойство не существует в этой позиции.

getParentRule

CSSRule getParentRule()

Правило CSS, содержащее этот блок объявления, или null, если этот CSSStyleDeclaration не прикреплен к CSSRule.

© 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/CSSStyleDeclaration.html