Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

sin() : le sinus d’un angle

Calculez un facteur périodique et multipliez-le par une longueur pour obtenir un déplacement.

Version : CSS Modules

Syntaxe

transform: translateY(calc(40px * sin(30deg)));

sin(A) accepte un calcul donnant un angle ou un nombre. Un angle peut utiliser deg, rad ou turn ; un nombre sans unité est interprété en radians. Pour une entrée finie, le résultat est un nombre sans unité compris entre -1 et 1. Il peut donc servir de facteur pour des positions ou dimensions. Multipliez-le par la dimension voulue dans calc() : sin(30deg) seul n’est pas une longueur CSS.

Supprimer l’unité ne permet pas de remplacer les degrés par des radians. sin(90deg) vaut 1, alors que sin(90) signifie 90 radians et vaut environ 0,894. La constante pi permet d’exprimer un quart de tour par sin(pi / 2), sans approximation décimale arrondie. Une longueur telle que 20px n’a pas le bon type, et un angle ou un nombre infini produit NaN plutôt qu’une valeur périodique exploitable.

L’exemple utilise une amplitude de 40px. Les angles 0deg, 30deg, 90deg et 270deg donnent des translations verticales de 0, 20, 40 et -40 pixels. pi / 2 donne également 40 pixels, mais 90 sans unité donne environ 35,76 pixels. Les valeurs sont lues dans les matrices de transformation calculées et affichées avec deux décimales ; la fonction ne lance aucune animation à elle seule.

Exemples

const box=document.createElement('div');document.body.append(box);
const displacement=angle=>{box.style.transform='translateY(calc(40px * sin('+angle+')))';return new DOMMatrixReadOnly(getComputedStyle(box).transform).m42.toFixed(2)};
console.log('degrees='+['0deg','30deg','90deg','270deg'].map(displacement).join(',')+'; radians='+displacement('pi / 2')+'; unitless-90='+displacement('90')+'; length-argument='+CSS.supports('transform','translateY(calc(40px * sin(20px)))'));

Résultat

degrees=0.00,20.00,40.00,-40.00; radians=40.00; unitless-90=35.76; length-argument=false

Exécuté dans Chromium 157.0.8103.51. L’exemple vérifie des calculs statiques et le refus d’un argument de longueur ; il ne mesure pas la qualité des animations. Prévoyez une solution de repli ou @supports pour les navigateurs sans fonctions trigonométriques CSS.

Sources