Интерфейс CSSStyleDeclaration

public interface CSSStyleDeclaration

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

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

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

См. также спецификацию объектной модели документа (DOM) уровня 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://docs.oracle.com/en/java/javase/25/docs/api/jdk.xml.dom/org/w3c/dom/css/CSSStyleDeclaration.html