clamp()

Maintient une valeur entre un minimum et un maximum, et la laisse croître en douceur entre les deux. La base de la typographie fluide.

Sur cette page

Exemple

#
CSS
.hero {
  padding: clamp(16px, 4vw, 40px);
}

.hero h2 {
  font-size: clamp(1.5rem, 1rem + 3vw, 2.75rem);
}
Aperçu

Le titre grandit avec le cadre d’aperçu, mais ne sera jamais plus petit que 24 px (1.5rem) ni plus grand que 44 px (2.75rem). L’espacement autour du contenu fonctionne de la même façon, entre 16 et 40 px.

Définition et utilisation

#

La fonction clamp(MIN, PRÉFÉRÉE, MAX) renvoie la valeur préférée, mais jamais moins que le minimum ni plus que le maximum. L’écriture clamp(1rem, 4vw, 2rem) se lit : « 4 % de la largeur de la fenêtre, mais pas moins de 1rem ni plus de 2rem ». C’est un raccourci de max(MIN, min(PRÉFÉRÉE, MAX)), en plus court et plus lisible.

L’usage le plus courant est la typographie fluide : un titre grandit avec la fenêtre, mais ne devient pas microscopique sur un téléphone ni gigantesque sur un grand écran. Elle convient tout aussi bien aux espacements (padding: clamp(12px, 3vw, 32px)) et aux largeurs (width: clamp(240px, 50%, 480px)). Une seule déclaration remplace alors plusieurs seuils dans les media queries.

La valeur du milieu doit dépendre de quelque chose de variable : vw, cqi ou des pourcentages. Une constante, comme clamp(1rem, 20px, 2rem), ne changera jamais. Pour la taille de police, ajoutez à vw un terme en rem, par exemple clamp(1rem, 0.8rem + 1.5vw, 2rem). Le texte réagit alors aussi au zoom de la page et aux réglages de police du navigateur.

Si le minimum est supérieur au maximum, c’est le minimum qui l’emporte. Dans les trois arguments, vous pouvez écrire des opérations sans le mot calc et mélanger les unités.

Syntaxe

#
Syntaxe
clamp(<minimum>, <valeur préférée>, <maximum>)

Paramètres

#
  • minimum

    16px

    La borne basse. Le conteneur fait ici 140 px, donc 11cqi donne environ 15 px, c’est trop peu, et le texte reçoit le minimum : 16 px. Faites glisser le coin inférieur droit du cadre vers la droite et vous verrez quand le texte commence à grandir.
  • valeur préférée

    11cqi

    La valeur qui s’applique tant qu’elle reste dans les bornes. Avec un conteneur de 200 px de large, 11cqi donne 22 px, soit une valeur comprise entre le minimum et le maximum. Le texte grandit et rétrécit avec le cadre.
  • maximum

    26px

    La borne haute. Le conteneur occupe tout le cadre, donc 11cqi dépasse 26 px et le texte s’arrête au maximum. Sans lui, le titre grandirait sans fin dans un conteneur large.

Paramètres en pratique

#

minimum

La borne basse. Le conteneur fait ici 140 px, donc 11cqi donne environ 15 px, c’est trop peu, et le texte reçoit le minimum : 16 px. Faites glisser le coin inférieur droit du cadre vers la droite et vous verrez quand le texte commence à grandir.
.demo { width: 140px; }
.demo h3 {
  font-size: clamp(16px, 11cqi, 26px);
}

valeur préférée

La valeur qui s’applique tant qu’elle reste dans les bornes. Avec un conteneur de 200 px de large, 11cqi donne 22 px, soit une valeur comprise entre le minimum et le maximum. Le texte grandit et rétrécit avec le cadre.
.demo { width: 200px; }
.demo h3 {
  font-size: clamp(16px, 11cqi, 26px);
}

maximum

La borne haute. Le conteneur occupe tout le cadre, donc 11cqi dépasse 26 px et le texte s’arrête au maximum. Sans lui, le titre grandirait sans fin dans un conteneur large.
.demo { width: 100%; }
.demo h3 {
  font-size: clamp(16px, 11cqi, 26px);
}

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

#
  • L’ordre des arguments est fixe : d’abord le minimum, puis la valeur préférée, enfin le maximum.
  • Pour la taille de police, ajoutez à vw un terme en rem, par exemple 1rem + 2vw. vw seul ne réagit pas au zoom de la page, ce qui gêne la lecture des personnes malvoyantes.
  • Dans les composants, utilisez cqi plutôt que vw. La taille dépendra alors de la place accordée au composant, et non de toute la fenêtre.

Entrées associées

#

Pratiquer dans les leçons

#

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