calc()

Calcule une valeur à partir d’une opération mathématique et permet de combiner différentes unités, par exemple des pourcentages avec des pixels.

Sur cette page

Exemple

#
CSS
.progress {
  height: 10px;
  border-radius: 999px;
  background: #27272a;
}

.progress-fill {
  width: calc(var(--progress) * 1%);
  height: 100%;
  border-radius: inherit;
  background: #10b981;
}
Aperçu

Le modèle de la page place simplement un nombre dans l’attribut style (--progress: 65), et calc() le convertit en largeur en pourcentage.

Définition et utilisation

#

La fonction calc() permet d’écrire une opération partout où CSS attend un nombre, une longueur, un angle, une durée ou un pourcentage. Elle prend en charge l’addition +, la soustraction -, la multiplication *, la division / et les parenthèses. Son plus grand atout est le mélange d’unités : calc(100% - 80px) signifie « toute la largeur du parent moins 80 pixels », une valeur impossible à calculer d’avance, car la largeur du parent n’est connue que dans le navigateur.

Les espaces autour de + et de - sont obligatoires. Sans eux, le navigateur lit -80px comme un nombre négatif et juge toute l’expression invalide. Autour de * et de /, les espaces ne sont pas exigés mais améliorent la lisibilité. Le plus simple est de multiplier ou de diviser une longueur par un nombre ordinaire : calc(10px * 3), calc(100% / 3). Le résultat doit convenir à la propriété : calc(10px * 3px), soit des pixels au carré, ne fonctionnera donc pas dans width.

La combinaison avec les variables CSS offre le plus de possibilités. Une variable peut ne contenir qu’un nombre, et calc() lui donne une unité : calc(var(--progress) * 1%). Vous pouvez aussi calculer les espacements à partir d’une valeur de base, par exemple calc(var(--gap) * 2). Les fonctions peuvent être imbriquées, et un calc() interne peut être remplacé par de simples parenthèses.

Lorsqu’une valeur doit avoir une limite haute ou basse, utilisez min(), max() ou clamp() plutôt que des calculs élaborés. Dans celles-ci aussi, vous écrivez les opérations sans le mot calc, par exemple min(100% - 2rem, 60ch).

Syntaxe

#
Syntaxe
propriété: calc(<valeur> <opérateur> <valeur>);

opérateurs : +  -  *  /

Opérations courantes

#
  • calc(100% - 80px)

    largeur du parent moins 80 px

    La tuile occupe toute la largeur du cadre sauf les 80 derniers pixels. Cet écart reste constant, quelle que soit la largeur du cadre.
  • calc(100% / 3)

    un tiers du parent

    Division par un nombre : la tuile fait exactement un tiers de la largeur du cadre.
  • calc(var(--n) * 40px)

    4 × 40px = 160px

    Un nombre issu d’une variable converti en longueur. Modifiez --n et la largeur se recalcule toute seule.
  • calc(1rem + 2vw)

    16px + 2 % de la largeur de la fenêtre

    Une taille de texte composée d’une partie fixe et d’une partie qui dépend de la fenêtre. Sur les écrans plus larges, le texte grandit, mais ne descend jamais sous 16 px.
  • calc(50% - 40px)

    centre du parent

    Le centrage classique d’un élément de largeur connue : la marge gauche vaut la moitié du parent moins la moitié de la tuile.
  • calc(360deg / 8)

    45deg

    Vous pouvez aussi faire des opérations sur des angles et des durées. Ici, l’angle de rotation est un huitième de tour complet, soit 45 degrés.

Opérations courantes en pratique

#

calc(100% - 80px)

La tuile occupe toute la largeur du cadre sauf les 80 derniers pixels. Cet écart reste constant, quelle que soit la largeur du cadre.
.demo { width: calc(100% - 80px); }

calc(100% / 3)

Division par un nombre : la tuile fait exactement un tiers de la largeur du cadre.
.demo { width: calc(100% / 3); }

calc(var(--n) * 40px)

Un nombre issu d’une variable converti en longueur. Modifiez --n et la largeur se recalcule toute seule.
.demo {
  --n: 4;
  width: calc(var(--n) * 40px);
}

calc(1rem + 2vw)

Une taille de texte composée d’une partie fixe et d’une partie qui dépend de la fenêtre. Sur les écrans plus larges, le texte grandit, mais ne descend jamais sous 16 px.
.demo { font-size: calc(1rem + 2vw); }

calc(50% - 40px)

Le centrage classique d’un élément de largeur connue : la marge gauche vaut la moitié du parent moins la moitié de la tuile.
.demo {
  width: 80px;
  margin-left: calc(50% - 40px);
}

calc(360deg / 8)

Vous pouvez aussi faire des opérations sur des angles et des durées. Ici, l’angle de rotation est un huitième de tour complet, soit 45 degrés.
.demo {
  width: 80px;
  margin: 16px auto;
  rotate: calc(360deg / 8);
}

Plus d’exemples

#
Une bannière pleine largeur dans une colonne étroite
CSS
.article {
  max-width: 280px;
  margin-inline: auto;
}

.full-bleed {
  margin-inline: calc(50% - 50vw);
}
Aperçu

La colonne de l’article fait 280 px, et pourtant la bannière atteint les bords du cadre. La marge négative 50% - 50vw est exactement la distance entre le bord de la colonne et le bord de la fenêtre.

Compatibilité des navigateurs

#

Largement disponible

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

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Entourez toujours + et - d’espaces. L’écriture calc(100%-20px) est invalide et le navigateur ignore toute la déclaration.
  • Un nombre issu d’une variable se convertit en unité par multiplication, par exemple calc(var(--n) * 1px). Coller l’unité, comme dans var(--n)px, ne fonctionne pas.
  • Pour borner des valeurs, utilisez clamp(), min() et max() plutôt que de bâtir des conditions dans calc(). Le code sera plus court et plus clair.

Entrées associées

#

Pratiquer dans les leçons

#

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