acos()

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La fonction (en-US) CSS acos() est une fonction trigonométrique qui renvoie le cosinus inverse d'un nombre compris entre -1 et 1. Cette fonction effectue un unique calcul qui renvoie le nombre correspondant de radians représentant un angle entre 0deg et 180deg.

Syntaxe

css
/* Valeurs numériques */
/* Type <number> */
transform: rotate(acos(-0.2));
transform: rotate(acos(2 * 0.125));

/* Autres valeurs */
transform: rotate(acos(pi / 5));
transform: rotate(acos(e / 3));

Paramètres

La fonction acos() prend un seul paramètre.

number

Un nombre (une valeur de type <number>) compris entre -1 et 1. Si la valeur fournie est 1, le résultat de la fonction sera 0.

Syntaxe formelle

<acos()> = 
  acos( <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

La fonction acos() peut être utilisée dans les transformations angulaires, par exemple avec rotate(), car elle renvoie une valeur de type <angle>.

css
div.box {
  width: 100px;
  height: 100px;
  background: linear-gradient(orange, red);
}

div.box-1 {
  transform: rotate(acos(-0.2));
}

div.box-2 {
  transform: rotate(acos(2 * 0.125));
}

div.box-3 {
  transform: rotate(acos(pi / 5));
}

div.box-4 {
  transform: rotate(acos(e / 3));
}

Spécifications

Specification
CSS Values and Units Module Level 4
# trig-funcs

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi