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.