Интерфейс CSSStyleDeclaration

public interface CSSStyleDeclaration

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

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

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

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

С момента:: 1.4, DOM уровень 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, 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://download.java.net/java/early_access/jdk24/docs/api/jdk.xml.dom/org/w3c/dom/css/CSSStyleDeclaration.html