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

CKTIS / CSS

sign() : une direction sans grandeur

Ramenez un calcul numérique à son signe et utilisez le résultat sans unité comme multiplicateur.

Version : CSS Modules

Syntaxe

transform: translateX(calc(sign(-8px) * 12px));

sign(A) évalue un calcul et renvoie -1 pour une valeur négative, +1 pour une valeur positive et zéro pour zéro. Le résultat est un nombre sans unité de longueur ou d’angle, même si l’argument est une longueur ou un angle. Il décrit donc une direction plutôt qu’une grandeur : sign(-8px) vaut -1, pas -1px ni 8px. abs() répond à un autre besoin et conserve la valeur absolue de l’argument.

Le signe est déterminé après résolution de l’argument. Un pourcentage positif ne donne pas nécessairement une longueur résolue positive : pour background-position, la différence servant de référence devient négative lorsque l’image dépasse la zone de positionnement. La spécification distingue aussi zéro positif et zéro négatif, tandis que NaN reste NaN. Le zéro affiché en décimal dans cet exemple ne teste pas le comportement du zéro signé.

L’exemple multiplie chaque signe par 12px pour une translation horizontale. Les arguments -8px, 0px et 8px donnent des déplacements de -12, 0 et 12 pixels ; -3deg donne également -12 pixels, car son signe est sans unité. Le navigateur refuse width: sign(8px), puisqu’un nombre non nul sans unité n’est pas une largeur. Les matrices de transformation mesurées confirment l’évaluation réelle.

Exemples

const box=document.createElement('div');document.body.append(box);
const move=value=>{box.style.transform='translateX(calc(sign('+value+') * 12px))';return new DOMMatrixReadOnly(getComputedStyle(box).transform).m41.toFixed(0)};
const negative=move('-8px'),zero=move('0px'),positive=move('8px'),angle=move('-3deg');
console.log('negative='+negative+'; zero='+zero+'; positive='+positive+'; angle='+angle+'; bare-width='+CSS.supports('width','sign(8px)')+'; supported='+CSS.supports('transform','translateX(calc(sign(-8px) * 12px))'));

Résultat

negative=-12; zero=0; positive=12; angle=-12; bare-width=false; supported=true

Vérifié dans Chromium 157.0.8103.51. Prévoyez une solution de repli ou @supports pour les navigateurs sans cette fonction mathématique. La résolution des pourcentages et le zéro signé sont expliqués à partir de la spécification, sans prétendre les avoir testés ici.

Sources