Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Fonction CSS atan()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2023.

La fonction CSS atan() est une fonction trigonométrique qui retourne l'arc tangente d'un nombre compris entre -∞ et +∞. La fonction contient un seul calcul qui retourne un angle (<angle>) compris entre -90deg et 90deg.

Syntaxe

css
/* Une seule valeur <number> */
transform: rotate(atan(1));
transform: rotate(atan(4 * 50));

/* Autres valeurs */
transform: rotate(atan(pi / 2));
transform: rotate(atan(e * 3));

Paramètres

La fonction atan(number) n'accepte qu'une seule valeur comme paramètre.

number

Un calcul qui résulte en un nombre (<number>) compris entre -∞ et +∞.

Valeur de retour

L'arc tangente d'un number retournera toujours un angle (<angle>) compris entre -90deg et 90deg.

  • Si number est 0⁻, le résultat est 0⁻.
  • Si number est +∞, le résultat est 90deg.
  • Si number est -∞, le résultat est -90deg.

C'est-à-dire :

  • atan(-infinity) représentant -90deg.
  • atan(-1) représentant -45deg
  • atan(0) représentant 0deg
  • atan(1) représentant 45deg
  • atan(infinity) représentant 90deg.

Syntaxe formelle

<atan()> = 
atan( <calc-sum> )

<calc-sum> =
<calc-product> [ [ '+' | '-' ] <calc-product> ]*

<calc-product> =
<calc-value> [ [ '*' | / ] <calc-value> ]*

<calc-value> =
<number> |
<dimension> |
<percentage> |
<calc-keyword> |
( <calc-sum> )

<calc-keyword> =
e |
pi |
infinity |
-infinity |
NaN

Exemples

Faire pivoter des éléments

La fonction atan() peut être utilisée avec rotate pour faire pivoter des éléments, car elle retourne un angle (<angle>).

HTML

html
<div class="box box-1"></div>
<div class="box box-2"></div>
<div class="box box-3"></div>
<div class="box box-4"></div>
<div class="box box-5"></div>

CSS

css
div.box {
  width: 100px;
  height: 100px;
  background: linear-gradient(orange, red);
}
div.box-1 {
  transform: rotate(atan(-99999));
}
div.box-2 {
  transform: rotate(atan(-1));
}
div.box-3 {
  transform: rotate(atan(0));
}
div.box-4 {
  transform: rotate(atan(1));
}
div.box-5 {
  transform: rotate(atan(99999));
}

Résultat

Spécifications

Spécification
CSS Values and Units Module Level 4
# trig-funcs

Compatibilité des navigateurs

Voir aussi