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

CKTIS / CSS

scale3d() : des échelles indépendantes sur trois axes

Modifiez séparément les échelles X, Y et Z sans recalculer les dimensions de mise en page de l’élément.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

transform: scale3d(2, 3, 4);

scale3d(sx, sy, sz) multiplie les coordonnées suivant trois axes. Les trois arguments séparés par des virgules sont obligatoires. Un facteur de 1 laisse son axe inchangé ; un facteur négatif le réfléchit. Les pourcentages représentent des facteurs : 50% signifie 0.5, et non la moitié d’une dimension du parent. Les longueurs comme 2px ne sont pas des facteurs d’échelle.

L’élément reste un plan, et non un solide doté d’une épaisseur. La mise à l’échelle de Z seule ne peut ni élargir ni rehausser sa surface non tournée située à z=0. Le facteur Z intervient pour des points décalés en profondeur et dans les compositions avec des rotations, des translations ou une perspective. transform-origin définit le point de référence ; l’ordre des fonctions modifie le résultat composé.

L’exemple transforme une boîte de 40×30px avec les facteurs 2,3,4. Son rectangle visible mesure 80×90px, tandis que offsetWidth et offsetHeight restent à 40×30. La matrice calculée transforme le point (1,2,5) en (2,6,20). La forme en pourcentages donne les facteurs diagonaux 0.5,1,1.5, et la forme incomplète à deux arguments est rejetée.

Exemples

const box=document.createElement('div');
box.style.cssText='position:fixed;left:60px;top:60px;width:40px;height:30px;transform-origin:0 0;transform:scale3d(2,3,4)';
document.body.append(box);
const rect=box.getBoundingClientRect();
const matrix=new DOMMatrix(getComputedStyle(box).transform);
const point=matrix.transformPoint(new DOMPoint(1,2,5));
box.style.transform='scale3d(50%,100%,150%)';
const percentages=new DOMMatrix(getComputedStyle(box).transform);
console.log('rendered='+rect.width+'x'+rect.height+'; layout='+box.offsetWidth+'x'+box.offsetHeight+'; point='+[point.x,point.y,point.z]+'; percentages='+[percentages.m11,percentages.m22,percentages.m33]+'; missing-z='+CSS.supports('transform','scale3d(2,3)'));

Résultat

rendered=80x90; layout=40x30; point=2,6,20; percentages=0.5,1,1.5; missing-z=false

Les dimensions rendues et celles de mise en page répondent à des questions différentes. La troisième coordonnée est vérifiée par la matrice calculée ; l’exemple ne prétend pas que la boîte possède une épaisseur physique.

Sources