Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

max-width

Baseline Large disponibilité *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

La propriété CSS max-width est utilisée pour définir la largeur maximale d'un élément. Elle empêche la valeur utilisée de la propriété width de devenir supérieure à la valeur définie par max-width.

Exemple interactif

max-width: 150px;
max-width: 20em;
max-width: 75%;
max-width: 20ch;
<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    Changez la largeur maximale.
  </div>
</section>
#example-element {
  display: flex;
  flex-direction: column;
  background-color: #5b6dcd;
  height: 80%;
  justify-content: center;
  color: white;
}

max-width surcharge width, mais min-width surcharge max-width.

Syntaxe

css
/* Valeur de type <length> */
max-width: 3.5em;
max-width: anchor-size(--my-anchor inline, 245px);
max-width: calc(anchor-size(width) + 4em);

/* Valeursde type <percentage> */
max-width: 75%;

/* Valeurs avec un mot-clé */
max-width: none;
max-width: max-content;
max-width: min-content;
max-width: fit-content;
max-width: fit-content(20em);
max-width: stretch;

/* Valeurs globales */
max-width: inherit;
max-width: initial;
max-width: revert;
max-width: revert-layer;
max-width: unset;

Valeurs

<length>

Définit la largeur maximale (max-width) avec une valeur absolue.

<percentage>

Définit la largeur maximale (max-width) en pourcentage de la largeur du bloc englobant.

none

Aucune limite sur la taille de la boîte.

max-content

La largeur maximale (max-width) intrinsèque préférée.

min-content

La largeur maximale (max-width) intrinsèque minimale.

fit-content

Utilise l'espace disponible, mais pas plus que max-content, c'est-à-dire min(max-content, max(min-content, stretch)).

fit-content(<length-percentage>) Expérimental

Utilise la formule fit-content avec l'espace disponible remplacé par l'argument défini, c'est-à-dire min(max-content, max(min-content, argument)).

stretch

Limite la largeur maximale de la marge de la boîte de l'élément à la largeur de son bloc englobant. Elle tente de faire en sorte que la marge remplisse l'espace disponible dans le bloc englobant, se comportant ainsi de manière similaire à 100%, mais en appliquant la taille résultante à la marge plutôt qu'à la boîte déterminée par box-sizing.

Note : Pour vérifier les alias utilisés par les navigateurs pour la valeur stretch et son état d'implémentation, consultez la section Compatibilité des navigateurs.

Accessibilité

Veiller à s'assurer que les éléments ciblés avec une règle utilisant max-width ne sont pas tronqués ou ne masquent pas d'autre contenu sur la page lorsqu'on zoome pour augmenter la taille du texte.

Définition formelle

Valeur initialenone
Applicabilitétous les éléments sauf les éléments en ligne non remplacés, les lignes de tableaux et les groupes de lignes
Héritéenon
Pourcentagesse rapporte à la largeur du bloc contenant
Valeur calculéele pourcentage comme défini ou la longueur absolue ou le mot-clé none
Type d'animationune longueur, pourcentage ou calc() ;

Syntaxe formelle

max-width = 
none |
<length-percentage [0,∞]> |
min-content |
max-content |
fit-content( <length-percentage [0,∞]> ) |
<calc-size()> |
<anchor-size()> |
stretch |
fit-content |
contain

<length-percentage> =
<length> |
<percentage>

<calc-size()> =
calc-size( <calc-size-basis> , <calc-sum> )

<anchor-size()> =
anchor-size( [ <anchor-name> || <anchor-size> ]? , <length-percentage>? )

<calc-size-basis> =
<size-keyword> |
<calc-size()> |
any |
<calc-sum>

<calc-sum> =
<calc-product> [ [ '+' | '-' ] <calc-product> ]*

<anchor-name> =
<dashed-ident>

<anchor-size> =
width |
height |
block |
inline |
self-block |
self-inline

<calc-product> =
<calc-value> [ [ '*' | / ] <calc-value> ]*

<calc-value> =
<number> |
<dimension> |
<percentage> |
<calc-keyword> |
( <calc-sum> )

<calc-keyword> =
e |
pi |
infinity |
-infinity |
NaN

Exemples

Définir une largeur maximale en pixels

Dans cet exemple, l'élément « enfant » aura la largeur la plus petite entre 150 et celle de l'élément « parent ».

HTML

html
<div id="parent">
  <div id="enfant">
    Fusce pulvinar vestibulum eros, sed luctus ex lobortis quis.
  </div>
</div>

CSS

css
#parent {
  background: lightblue;
  width: 300px;
}

#enfant {
  background: gold;
  width: 100%;
  max-width: 150px;
}

Résultat

Spécifications

Spécification
CSS Box Sizing Module Level 4
# sizing-values

Compatibilité des navigateurs

Voir aussi