CSSStyleDeclaration: getPropertyCSSValue() метод

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или поддерживаться только для совместимости. Избегайте её использования и, по возможности, обновите существующий код; см. таблицу совместимости внизу этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любой момент.

Метод интерфейса CSSStyleDeclaration.getPropertyCSSValue() возвращает CSSValue, содержащий значение CSS для свойства. Обратите внимание, что он возвращает null если имя свойства — сокращённое свойство.

Примечание: Этот интерфейс был частью попытки создать типизированную модель объекта CSS. Эта попытка была оставлена, и большинство браузеров не реализуют её.

Для достижения вашей цели вы можете использовать:

CSSStyleDeclaration.getPropertyValue() нетипизированной модели объекта CSS, широко поддерживаемой, или
Element.computedStyleMap() современной типизированной модели объекта CSS API, менее поддерживаемой и рассматриваемой как экспериментальная.

Синтаксис

getPropertyCSSValue(property)

Параметры

property: Строка, представляющая имя свойства, которое нужно получить.

Возвращаемое значение

A CSSValue содержащий значение CSS для свойства. Если такового нет, возвращает null.

Примеры

Следующий код JavaScript получает объект, содержащий вычисленные значения RGB свойства color CSS:

const style = window.getComputedStyle(elem, null);
const rgbObj = style.getPropertyCSSValue("color").getRGBColorValue();

Спецификации

Эта функция была первоначально определена в спецификации DOM Style Level 2, но с тех пор была исключена из любых стандартизующих усилий.

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

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getPropertyCSSValue`	1–40	Нет	1–61 Возвращает результат только при вызове на результате `getComputedStyle()`.	15–27	1	18–40	4–61	14–27	1	1.0–4.0	4.4–41

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CSSStyleDeclaration/getPropertyCSSValue