База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

CSSStyleDeclaration.setProperty — задаване на CSS декларации

Задавайте CSS декларации с setProperty(), като подадете име на свойство, стойност и незадължителен приоритет.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

style.setProperty(property, value, priority = "")

CSSStyleDeclaration.setProperty променя декларация, например в element.style. Това е API на браузъра, а не функция на ECMAScript. Използвайте CSS имена като margin-top, а не marginTop; имената на потребителски свойства като --accent различават главни и малки букви.

priority приема "" или "important", като при втората стойност регистърът няма значение. Не поставяйте !important в value. В блок от декларации, който може да се променя, празната стойност премахва декларацията преди проверката на приоритета, дори ако той е невалиден. При непразна стойност невалидният приоритет не води до промяна.

Неподдържаните свойства и невалидните стойности не водят до промяна. Блок само за четене предизвиква NoModificationAllowedError. Методът връща undefined.

Примери

const style = document.createElement("div").style;
style.setProperty("margin-top", "12px", "important");
console.log(style.getPropertyValue("margin-top"));
console.log(style.getPropertyPriority("margin-top"));
style.setProperty("margin-top", "");
console.log(JSON.stringify(style.getPropertyValue("margin-top")));

Резултат

12px
important
""

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници