La propriété max-width est utilisée pour définir la largeur maximale d'un élément donné. Elle empêche la valeur de la propriété width de devenir supérieure à la valeur spécifiée par max-width (autrement dit, max-width est une borne supérieur pour width).
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
La valeur de max-width surcharge la valeur de width mais elle est surchargée par min-width.
Syntaxe
/* Valeur de longueur */ /* Type <length> */ max-width: 3.5em; /* Valeurs relatives */ /* Type <percentage> */ max-width: 10%; /* Valeurs avec un mot-clé */ max-width: none; max-width: max-content; max-width: min-content; max-width: fit-content; max-width: fill-available; /* Valeurs globales */ max-width: inherit; max-width: initial; max-width: unset;
Valeurs
<length>- La largeur minimale fixée. Voir
<length>pour les unités qu'on peut utiliser. Une largeur négative rendra la déclaration invalide. <percentage>- La largeur minimale fixée, exprimée comme un fraction de la largeur du bloc englobant. Voir la page
<percentage>sur les valeurs possibles avec ce type. Les valeurs négatives rendront la déclaration invalide. fill-available- La largeur du bloc englobant moins la marge horizontale, la bordure et le remplissage (padding). Certains navigateurs implémentent cette valeur avec un ancien nom :
available. fit-content- Un synonyme pour
max-content. max-content- La largeur intrinsèque préférée.
min-content- La largeur intrinsèque minimale.
none- Il n'y a pas de maximum pour la largeur. C'est la valeur par défaut.
Syntaxe formelle
<length> | <percentage> | none | max-content | min-content | fit-content | fill-available
Exemples
Exemple simple avec un tableau
HTML
<div> Lorem ipsum tralala sit amet, consectetur adipisicing
<p>
Ut enim ad minim veniam, quis nostrud exercitation
ullamco laboris nisi ut aliquip ex ea commodo consequat.
</p>
</div>
CSS
div {
width: 250px;
border: solid 1px red;
}
p {
max-width: 60%;
border: solid 1px blue;
}
Résultat
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.
- Comprendre les règles WCAG 1.4
- Understanding Success Criterion 1.4.4, W3C Understanding WCAG 2.0 (en anglais)
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| CSS Intrinsic & Extrinsic Sizing Module Level 3 La définition de 'max-width' dans cette spécification. |
Version de travail | Ajout des mots-clés max-content, min-content, fit-content et fill-available. Les deux brouillons de spécifications CSS3 Box et CSS3 Writing Modes définissaient ces mots-clés mais ont été remplacées par cette spécification. |
| CSS Transitions La définition de 'max-width' dans cette spécification. |
Version de travail | max-width peut désormais être animée. |
| CSS Level 2 (Revision 1) La définition de 'max-width' dans cette spécification. |
Recommendation | Définition initiale. |
| Valeur initiale | none |
|---|---|
| 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ée | non |
| Pourcentages | se rapporte à la largeur du bloc contenant |
| Média | visuel |
| Valeur calculée | le pourcentage comme spécifié ou la longueur absolue ou le mot-clé none |
| Type d'animation | une longueur, pourcentage ou calc() ; |
| Ordre canonique | l'ordre unique et non-ambigu défini par la grammaire formelle |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | 1 | 12 | 11 | 7 | 42 | 2 |
fit-content, max-content, and min-content | Non3 | Non | 3 -moz- 4 | Non | Non | Non5 |
fill-available | Non | Non | Non | Non | Non | Non |
| Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Support simple | ? | ? | Oui | ? | ? | ? | ? |
fit-content, max-content, and min-content | ? | ? | ? | Non | ? | ? | Non |
fill-available | ? | ? | ? | ? | ? | ? | Non |
1. CSS 2.1 leaves the behavior of max-width with table undefined. Firefox supports applying max-width to table elements.
2. CSS 2.1 leaves the behavior of max-width with table undefined. Opera supports applying max-width to table elements.
3. Chrome implements an earlier proposal for setting width to an intrinsic width: the keywords intrinsic (instead of max-content), and min-intrinsic (instead of min-content). There is no equivalent for fill-available or fit-content.
4. Firefox implements the definitions given in CSS3 Basic Box. This defines available and not fit-available. Also, the definition of fit-content is simpler than in CSS3 Sizing.
5. Safari implements an earlier proposal for setting width to an intrinsic width: the keywords intrinsic (instead of max-content), and min-intrinsic (instead of min-content). There is no equivalent for fill-available or fit-content.