CKTIS / JavaScript
HTMLElement.style : transform et height
Définissez la transformation et la hauteur d’un élément en JavaScript, puis distinguez les déclarations en ligne des valeurs résolues par la cascade CSS.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const style = element.style;
style.transform = "translateY(12px)";
style.height = "80px";
style.removeProperty("transform");
style.height = "";HTMLElement.style renvoie un objet qui reflète en temps réel l’attribut style de l’élément, même si vous conservez une référence à cet objet. La spécification actuelle renvoie CSSStyleProperties, qui hérite de CSSStyleDeclaration ; certains navigateurs peuvent encore renvoyer CSSStyleDeclaration. Ces API relèvent de la plateforme web, pas d’ECMAScript 2024.
L’objet ne peut pas être remplacé : une affectation directe à element.style définit cssText et remplace le bloc de déclarations. Utilisez element.style.transform et element.style.height pour lire ou modifier une déclaration à la fois. Affectez des chaînes CSS valides comme "80px". En mode standard, une valeur non nulle et sans unité comme "81" affectée à height est ignorée sans lever d’exception et laisse la valeur précédente intacte. En mode de compatibilité (quirks mode), les navigateurs peuvent au contraire l’interpréter comme une longueur en pixels.
transform modifie le rendu d’une boîte transformable : translateY(12px) la décale de 12 pixels CSS vers le bas, sans changer la place qu’elle occupe dans le flux normal. height indique une hauteur utilisée pour la mise en page : celle de la boîte de contenu par défaut, ou celle de la boîte de bordure avec box-sizing: border-box.
La lecture d’une déclaration en ligne absente renvoie "". Affecter "" ou appeler removeProperty() supprime cette déclaration ; ce n’est pas la même chose que définir transform: none ou height: auto. Pour lire les valeurs résolues après la cascade, utilisez l’objet en lecture seule renvoyé par getComputedStyle(element).
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTMLElement.style: transform and height</title>
</head>
<body>
<script>
(() => {
const element = document.createElement("div");
const style = element.style;
const log = () => console.log(JSON.stringify([style.transform, style.height]));
style.transform = "translateY(12px)";
style.height = "80px";
log();
style.height = "81";
log();
style.removeProperty("height");
log();
})();
</script>
</body>
</html>Résultat
["translateY(12px)","80px"] ["translateY(12px)","80px"] ["translateY(12px)",""]
Enregistrez l’exemple complet dans un fichier HTML et ouvrez-le dans un navigateur. Conservez `<!doctype html>` pour que la page soit traitée en mode standard. Vérifiez la sortie dans la console du navigateur. L’élément n’est pas rattaché au document : la sortie montre les déclarations en ligne, pas les dimensions affichées.
Leçons associées
- JavaScript · Leçon 11 · Avancé · Version : 4