CKTIS / JavaScript
HTMLElement.style — styles intégrés d’un élément
HTMLElement.style expose un objet de déclarations CSS intégré et modifiable, et non le résultat de la cascade.
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
element.style.propertyName = "value";
element.style.setProperty("property-name", "value", "important");
element.style.removeProperty("property-name");HTMLElement.style renvoie toujours le même objet de déclarations intégrées associé à l’attribut style. La spécification le définit comme CSSStyleProperties, qui hérite de CSSStyleDeclaration.
Utilisez des noms en camelCase, comme marginTop, ou setProperty() avec des noms CSS. Pour les propriétés personnalisées, utilisez setProperty(). Indiquez la priorité important comme troisième argument, et non dans la valeur.
removeProperty() supprime une déclaration ; une valeur absente est lue comme "". style n’expose pas le résultat de la cascade : utilisez getComputedStyle() pour cela. Affecter du texte à element.style le transmet à cssText et remplace tout le bloc intégré, et non une seule déclaration.
Exemples
const element = document.createElement("div");
const style = element.style;
style.marginTop = "12px";
style.setProperty("--gap", "8px");
console.log(style === element.style);
console.log(style.marginTop);
console.log(style.getPropertyValue("--gap"));
style.removeProperty("margin-top");
console.log(JSON.stringify(style.marginTop));Résultat
true 12px 8px ""
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.