min()

Choisit la plus petite des valeurs données. Elle sert de limite haute, par exemple une largeur de 100 % du parent, mais pas plus de 600px.

Sur cette page

Exemple

#
CSS
.container {
  width: min(100% - 2rem, 480px);
  margin-inline: auto;
}
Aperçu

Sur ordinateur, 480px l’emporte. Sur téléphone, 100% - 2rem est plus petit : la colonne remplit donc l’écran avec 1rem d’espace sur les côtés.

Définition et utilisation

#

La fonction min() accepte un nombre quelconque de valeurs séparées par des virgules et renvoie la plus petite. Son intérêt apparaît quand vous mélangez des unités : width: min(100%, 600px) signifie « toute la largeur du parent, mais pas plus de 600 pixels ». Sur un téléphone, 100 % l’emporte ; sur un grand écran, 600px.

On s’y trompe facilement, car le nom suggère une borne basse alors que c’est l’inverse : min() fixe un maximum. Si une valeur ne doit croître que jusqu’à un certain plafond, c’est bien min(). L’écriture width: min(100%, 600px) fait la même chose que la paire width: 100%; max-width: 600px;, mais en une seule déclaration.

Dans les arguments, vous pouvez écrire des opérations sans calc(), par exemple min(100% - 2rem, 60ch), et utiliser des variables. La fonction marche dans toute propriété qui accepte des nombres, des longueurs, des pourcentages, des angles ou des durées : dans width, padding, font-size, gap, et aussi à l’intérieur de minmax() dans une grille.

Syntaxe

#
Syntaxe
min(<valeur>, <valeur> [, <valeur>]*)

Usages courants

#
  • min(100%, 220px)

    220px, dans un cadre étroit 100 %

    Une limite haute de largeur. Le cadre est plus large que 220 px, donc la tuile fait 220 px. Faites glisser le coin inférieur droit du cadre vers la gauche : quand il devient plus étroit, la tuile occupe 100 %.
  • min(100% - 40px, 180px)

    180px ou 100% - 40px

    Une opération dans un argument, sans écrire calc(). Dans un cadre large, la tuile s’arrête à 180 px ; dans un cadre étroit, elle laisse 40 px d’espace libre à droite.
  • min(26ch, 100%)

    26ch

    Une longueur de ligne confortable. Le paragraphe fait au plus 26ch de large, et dans un cadre plus étroit il le remplit simplement au lieu de déborder.
  • minmax(min(90px, 100%), 1fr)

    colonnes à partir de 90px

    Une grille sûre. Les colonnes font au moins 90 px, mais quand le cadre est plus étroit, le minimum descend à 100 % et rien ne dépasse du bord. Rétrécissez le cadre et les tuiles passent sur une seule colonne.

Usages courants en pratique

#

min(100%, 220px)

Une limite haute de largeur. Le cadre est plus large que 220 px, donc la tuile fait 220 px. Faites glisser le coin inférieur droit du cadre vers la gauche : quand il devient plus étroit, la tuile occupe 100 %.
.demo { width: min(100%, 220px); }

min(100% - 40px, 180px)

Une opération dans un argument, sans écrire calc(). Dans un cadre large, la tuile s’arrête à 180 px ; dans un cadre étroit, elle laisse 40 px d’espace libre à droite.
.demo { width: min(100% - 40px, 180px); }

min(26ch, 100%)

Une longueur de ligne confortable. Le paragraphe fait au plus 26ch de large, et dans un cadre plus étroit il le remplit simplement au lieu de déborder.
.demo { width: min(26ch, 100%); margin: 0; }

minmax(min(90px, 100%), 1fr)

Une grille sûre. Les colonnes font au moins 90 px, mais quand le cadre est plus étroit, le minimum descend à 100 % et rien ne dépasse du bord. Rétrécissez le cadre et les tuiles passent sur une seule colonne.
.demo {
  display: grid;
  grid-template-columns:
    repeat(auto-fill, minmax(min(90px, 100%), 1fr));
  gap: 8px;
}

Compatibilité des navigateurs

#

Largement disponible · depuis 2020

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Retenez : min() fixe une limite haute et max() une limite basse. Le résultat de min() ne dépassera jamais le plus petit de ses arguments.
  • L’écriture width: min(100%, 600px) remplace la paire width: 100% et max-width: 600px.
  • Dans les grilles avec repeat(auto-fill, …), écrivez le minimum d’une colonne sous la forme min(200px, 100%). Sur un écran très étroit, la colonne ne dépassera pas de son parent.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.