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

CKTIS / CSS

min() — une limite supérieure adaptative

Choisissez la plus petite valeur compatible pour plafonner une largeur fluide sans confondre ce plafond avec une taille minimale.

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

Syntaxe

min(value, ...)
width: min(100% - 20px, 300px);

min() renvoie le plus petit résultat d’une ou plusieurs expressions séparées par des virgules. La déclaration width: min(100% - 20px, 300px) réserve 20 pixels par rapport au bloc contenant et plafonne la largeur choisie à 300 pixels. Malgré son nom, elle impose ici une limite supérieure, pas un minimum.

Les opérations peuvent figurer directement dans un argument sans calc() supplémentaire. Gardez des espaces autour des signes d’addition et de soustraction et utilisez des types compatibles. Une largeur peut combiner longueurs et pourcentages, mais comparer 10px à 1s est invalide. Le pourcentage exige une référence ; l’exemple fixe explicitement la largeur du parent.

D’autres contraintes continuent de s’appliquer après le choix de la valeur. Ici, min-width peut augmenter la largeur finale au-delà du résultat calculé et provoquer un débordement du parent étroit. Le contenu, le remplissage et le modèle de boîte influencent également l’espace occupé. Pour imposer à la fois un plancher et un plafond, choisissez une expression bornée plutôt que de vous fier au nom de la fonction.

Exemples

const parent = document.createElement('div');
const child = document.createElement('div');
parent.append(child);
document.body.append(parent);
child.style.width = 'min(100% - 20px, 300px)';
for (const width of [600, 240, 80]) {
  parent.style.width = width + 'px';
  console.log(width + ':', getComputedStyle(child).width);
}
child.style.minWidth = '100px';
console.log('with min-width:', getComputedStyle(child).width);
console.log('mixed length/time:', CSS.supports('width', 'min(10px, 1s)'));
parent.remove();

Résultat

600: 300px
240: 220px
80: 60px
with min-width: 100px
mixed length/time: false

Le navigateur calcule 300, 220 et 60 pixels pour des parents de 600, 240 et 80 pixels. L’ajout d’un minimum de 100 pixels porte le dernier résultat à 100. Il s’agit d’une mesure réelle de mise en page, pas d’une reproduction du calcul CSS en JavaScript.

Sources