Интерфейс CSSStyleDeclaration

public interface CSSStyleDeclaration

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

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

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

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

С момента:: 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.