Объект CSSStyleDeclaration.

  CSSStyleDeclaration - Является интерфейсом к коллекциям атрибутов стилей CSS.
  Каждый элемент такой коллекции содержит значение атрибута стиля соответствующее имени атрибута стиля.
  Коллекция CSSStyleDeclaration может быть динамической, то есть она автоматически обновляется, если динамические изменения в DOM затрагивают элементы этой коллекции, и наоборот, изменения скриптом такой коллекции приводит к соответствующим изменениям в DOM.
  В противном случае коллекция CSSStyleDeclaration будет статической, то есть её надо переполучать при изменениях в DOM.
  Экземпляр доступен:

  1. Через свойство style объекта HTMLElement
  2. Через свойство style объекта CSSStyleRule
  3. Через свойство style объекта CSSKeyframeRule
  4. С помощью метода getComputedStyle объекта Window
      Если экземпляр объекта CSSStyleDeclaration был получен с помощью метода getComputedStyle объекта Window, то:
    1. Это статическая коллекция.
    2. Все свойства Имя атрибута находящиеся в такой коллекции доступны только для чтения.
    3. Свойство cssText будет содержать все возможные атрибуты стилей, в том числе и те, которые не заданы явно, но имеют значения по умолчанию.
    4. Все значения атрибутов стилей CSS находящихся в такой коллекции, которые определяют размер, будут выражены в пикселах с добавлением суффикса px.
    5. Все значения атрибутов стилей CSS находящихся в такой коллекции, которые определяют цвет, будут иметь формат rgb.
    6. Обобщенные атрибуты стилей CSS (например такие как font) не будут включены в такую коллекцию, в ней будут находиться только конкретные атрибуты стилей CSS (например такие как font-size).
  Свойства.
  cssText - Содержит строку всех атрибутов стилей в коллекции с их значениями.
  Значение имеет строковый формат.
  Если экземпляр объекта получен через свойство style объекта HTMLElement, то значение совпадает со значением атрибута STYLE.
  Если экземпляр объекта получен через свойство style объекта CSSStyleRule, то значение соответствует значению его свойства cssText исключая селектор CSS и фигурные скобки.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.cssText[= Значение]

Значения формата записи:

  length - Содержит количество элементов (атрибутов стилей CSS) в коллекции.
  Значение имеет числовой формат.
  Это значение, как правило, больше фактического количества атрибутов стилей, которые содержатся в строке cssText.
  Это происходит из за того, что один групповой атрибут стилей (например background) в строке cssText влечёт за собой появление в коллекции всех своих составляющих.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.length

Значения формата записи:

  parentRule - Содержит ссылку на интерфейс CSSStyleRule к CSS-правилу, из которого получена коллекция.
  Если коллекция получена помимо экземпляра объекта CSSStyleRule, то свойство parentRule содержит значение null.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.parentRule

Значения формата записи:

  Имя атрибута - Содержит значение атрибута стиля соответствующее имени атрибута стиля.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.Имя атрибута[= Значение]

Значения формата записи:

  • Экземпляр объекта CSSStyleDeclaration - Любой операнд значения со значением экземпляра объекта CSSStyleDeclaration.
  • . - Оператор доступа к свойству объекта.
  • Имя атрибута - Непосредственная запись имени атрибута стиля.
      Из имени атрибута, в котором несколько слов пишутся через дефис, дефис должен быть удален, а каждое слово, кроме первого, пишется с большой буквы (например - backgroundColor).
      Если имя атрибута, совпадает с именем зарезервированной переменной JavaScript, то к имени атрибута добавляется слева префикс css и имя атрибута пишется с большой буквы (например - cssFloat).
      Если атрибута с заданным именем нет в коллекции, то он будет добавлен с заданным значением.
  • = - Оператор присвоения. Ключевое слово в этом формате.
  • Значение - Правильный код нового значения атрибута стилей CSS, заданный в любом строковом формате.
      Соответственно может измениться отображение Web-страницы.
  Указатель - Содержит имя атрибута стиля, соответствующее указателю.
  Значение имеет строковый формат.
  Имя атрибута стиля соответствует его записи в коде CSS, а не значению свойства Имя атрибута объекта CSSStyleDeclaration.
  Как правило, в коллекции больше элементов, чем фактическое количество атрибутов стилей, которые содержатся в строке cssText.
  Это происходит из за того, что один групповой атрибут стилей (например background) в строке cssText влечёт за собой появление в коллекции всех своих составляющих. Поэтому пользоваться свойством указатель не очень-то удобно.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration[Указатель]

Значения формата записи:

  • Экземпляр объекта CSSStyleDeclaration - Любой операнд значения со значением экземпляра объекта CSSStyleDeclaration.
  • [ - Оператор группировки. Ключевое слово в этом формате.
  • Указатель - Значение порядкового номера атрибута стиля в коллекции заданное в любом числовом формате.
      Указатель первого элемента коллекции равен 0.
      По существу каждый указатель является свойством экземпляра объекта CSSStyleDeclaration, которое содержит ссылку на соответствующий элемент коллекции. А, поскольку доступ к свойству любого объекта возможен как к элементу массива, то, в случае с объектами-коллекциями, такой формат доступа удобно использовать в циклах.
  • ] - Оператор группировки. Ключевое слово в этом формате.
  Методы.
  getPropertyPriority - Возвращает приоритет значения атрибута стиля по его заданному имени.
  Возвращаемое значение имеет строковый формат.
  Значение содержит либо ключевое слово !important либо пусто.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.getPropertyPriority(Имя)

Значения формата записи:

  getPropertyValue - Возвращает значение атрибута стиля по заданному имени.
  Возвращаемое значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.getPropertyValue(Имя)

Значения формата записи:

  item - Возвращает имя атрибута стиля в коллекции, соответствующее заданному указателю.
  Возвращаемое значение имеет строковый формат.
  Имя атрибута стиля соответствует его записи в коде CSS, а не значению свойства Имя атрибута объекта CSSStyleDeclaration.
  Как правило, в коллекции больше элементов, чем фактическое количество атрибутов стилей, которые содержатся в строке cssText.   Это происходит из за того, что один групповой атрибут стилей (например background) в строке cssText влечёт за собой появление в коллекции всех своих составляющих. Поэтому пользоваться методом item не очень-то удобно.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.item(Указатель)

Значения формата записи:

  removeProperty - Удаляет заданный атрибут стиля из коллекции.
  Возвращает бывшее значение удалённого атрибута стиля в строковом формате.
  Соответственно может измениться отображение Web-страницы.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.removeProperty(Имя)

Значения формата записи:

  setProperty - Добавляет новый или заменяет имеющийся атрибут стиля.
  Возвращает значение undefined.
  Соответственно может измениться отображение Web-страницы.

Формат записи в коде скрипта:

  • Экземпляр объекта CSSStyleDeclaration.setProperty(Имя, Значение[, Приоритет])

Значения формата записи: