Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

CSSStyleDeclaration.setProperty — nastavení deklarací CSS

Nastavujte deklarace CSS pomocí setProperty() předáním názvu vlastnosti, hodnoty a volitelné priority.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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

CSSStyleDeclaration.setProperty mění deklaraci, například v element.style. Jde o rozhraní prohlížeče, nikoli o funkci ECMAScriptu. Používejte názvy CSS, například margin-top, nikoli marginTop; názvy vlastních vlastností, jako --accent, rozlišují velká a malá písmena.

priority přijímá "" nebo "important", přičemž u druhé hodnoty nezáleží na velikosti písmen. Do value nevkládejte !important. V bloku deklarací, který lze upravovat, prázdná hodnota odstraní deklaraci ještě před kontrolou priority, a to i v případě, že je priorita neplatná. U neprázdné hodnoty neplatná priorita nezpůsobí žádnou změnu.

Nepodporované vlastnosti a neplatné hodnoty nezpůsobí žádnou změnu. Blok pouze pro čtení vyvolá NoModificationAllowedError. Metoda vrací undefined.

Příklady

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")));

Výsledek

12px
important
""

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje