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

CKTIS / CSS

width — largeur préférée d’un élément

La propriété width définit la largeur physique préférée de la boîte d’un élément. Elle accepte notamment des longueurs, des pourcentages et auto ; la taille finale dépend aussi du modèle de boîte, des contraintes et de la mise en page.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

/* Selected values from CSS Box Sizing Levels 3 and 4; not the full grammar. */
width: auto | <length-percentage [0,∞]> | min-content | max-content | fit-content | fit-content(<length-percentage [0,∞]>) | stretch | contain;
/* CSS-wide keywords are also accepted. */

width définit la largeur préférée selon l’axe physique, indépendamment du sens d’écriture. Sa valeur initiale est auto et elle n’est pas héritée. Elle ne s’applique pas aux éléments en ligne non remplacés.

Les longueurs et les pourcentages doivent être non négatifs. Un pourcentage se rapporte à la largeur du bloc contenant, qui n’est pas nécessairement celle de l’élément parent. auto confie le calcul aux règles de mise en page et ne signifie pas simplement 100%.

Avec box-sizing: content-box, la largeur désigne le contenu ; avec box-sizing: border-box, elle inclut aussi le remplissage et les bordures, mais pas les marges. min-width et max-width limitent le résultat, et l’algorithme de mise en page peut modifier la taille finale.

min-content et max-content désignent des tailles déterminées par le contenu. fit-content tient compte de l’espace disponible, tandis que fit-content() accepte une limite explicite. stretch remplit l’espace disponible en utilisant la boîte de marge. La syntaxe décrit la spécification ; elle ne garantit pas la prise en charge de toutes les valeurs dans le navigateur cible.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>width</title>
<style>
  .container { width: 400px; }
  .box {
    box-sizing: border-box;
    width: 50%;
    padding: 10px;
    border: 2px solid;
  }
</style>
<div class="container"><div class="box">width</div></div>
<pre id="result"></pre>
<script>
  const box = document.querySelector('.box');
  document.querySelector('#result').textContent =
    box.getBoundingClientRect().width + 'px';
</script>

Résultat

width
200px

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