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 ""
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.