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

CKTIS / JavaScript

Largeur et hauteur en style en ligne : `style.width` et `style.height`

Utilisez `element.style.width` et `element.style.height` pour lire, définir ou supprimer des déclarations CSS en ligne. Lire une déclaration ne revient pas à mesurer l’élément.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.style.width
 element.style.height
 element.style.width = cssWidth
 element.style.height = cssHeight
 element.style.width = ""
 element.style.height = ""

element.style.width et element.style.height permettent de lire et de modifier les déclarations CSS dans l’attribut style d’un élément HTML, et non ses attributs HTML width et height. element.style renvoie un objet de déclarations mis à jour en direct, pas une copie figée. Chaque propriété renvoie du texte CSS ou "" en l’absence de déclaration en ligne, même si une feuille de style fournit une valeur.

Affectez des chaînes comme "120px", "50%" ou "auto". Ajoutez px pour exprimer une taille en pixels : l’API n’ajoute pas d’unité à un nombre. Une valeur invalide comme "invalid" laisse la déclaration existante intacte. "" supprime la déclaration en ligne et laisse la cascade déterminer la valeur ; "auto", au contraire, définit une déclaration.

Une déclaration en ligne ne garantit pas la taille finale. La cascade, la mise en page et des contraintes telles que max-width peuvent l’influencer. Ces propriétés ne s’appliquent pas aux éléments en ligne non remplacés, comme un span ordinaire. box-sizing indique si la taille porte sur la boîte de contenu (content-box) ou inclut aussi le remplissage et les bordures (border-box).

Pour un élément qui participe à la mise en page, lisez getComputedStyle(element).width ou .height pour obtenir la valeur CSS résolue sous forme de texte. Pour obtenir les dimensions du rectangle englobant en pixels CSS, appelez element.getBoundingClientRect() et lisez ses valeurs numériques width et height. Ce rectangle inclut le remplissage et les bordures et tient compte des transformations CSS. Il s’agit d’API du navigateur, et non de fonctionnalités d’ECMAScript 2024 : un environnement avec un DOM est nécessaire.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Inline width and height</title>
<script>
  const element = document.createElement("div");
  const style = element.style;
  const log = () => console.log(JSON.stringify([style.width, style.height]));

  log();
  element.style.width = "50%";
  element.style.height = "80px";
  log();

  element.style.width = "invalid";
  log();

  element.style.width = "";
  element.style.height = "auto";
  log();
</script>

Résultat

["",""]
["50%","80px"]
["50%","80px"]
["","auto"]

Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et consultez la console de développement. Le `div` n’est pas inséré dans le document : les quatre lignes montrent des déclarations, pas des mesures de mise en page.

Leçons associées

  • JavaScript · Leçon 12 · Avancé · Version : 4

Sources