Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

CSSStyleDeclaration.setProperty — définir des déclarations CSS

Définissez des déclarations CSS avec setProperty() en indiquant un nom de propriété, une valeur et une priorité facultative.

Version : 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 modifie une déclaration, par exemple dans element.style. Il s’agit d’une API du navigateur, et non d’une fonctionnalité ECMAScript. Utilisez des noms CSS tels que margin-top, et non marginTop ; les noms de propriétés personnalisées comme --accent sont sensibles à la casse.

priority accepte "" ou "important", sans tenir compte de la casse. Ne placez pas !important dans value. Dans un bloc de déclarations modifiable, une valeur vide supprime la déclaration avant la vérification de la priorité, même si celle-ci est invalide. Si la valeur n’est pas vide, une priorité invalide n’entraîne aucun changement.

Les propriétés non prises en charge et les valeurs invalides n’entraînent aucun changement. Un bloc en lecture seule déclenche NoModificationAllowedError. La méthode renvoie undefined.

Exemples

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

Résultat

12px
important
""

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources