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

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.

Sources