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

CKTIS / CSS

rotateZ() : tourner dans le plan de l’écran

Utilise l’axe Z pour une rotation plane tout en conservant la boîte de mise en page initiale.

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

Syntaxe

transform: rotateZ(90deg);

La fonction rotateZ() tourne autour de l’axe Z local, dirigé hors de l’écran dans le système CSS habituel. Son angle produit la même transformation géométrique que rotate(). Avec X vers la droite et Y vers le bas, un angle positif de 90deg fait descendre un point situé à droite ; -90deg le fait monter. Le pivot vient de transform-origin et ne se trouve pas nécessairement dans le coin supérieur gauche.

La rotation modifie la forme dessinée et son rectangle englobant dans la fenêtre, pas les dimensions utilisées par le flux normal. Des éléments voisins peuvent donc la chevaucher. Les fonctions de transformation se composent dans un ordre déterminé : une translation placée avant ou après une rotation peut déplacer la boîte différemment. Ne déduis pas les dimensions de mise en page du rectangle englobant un élément tourné et ne compte pas sur rotateZ() pour créer une perspective.

L’exemple fixe le pivot en haut à gauche d’une boîte de 80px sur 20px placée en 200px,200px. À 90deg, son rectangle englobant vaut 180,200,20,80 ; à -90deg, il vaut 200,120,20,80. Le point local 10,0 devient 0,10 ou 0,-10. Enfin, les matrices calculées pour rotate(90deg) et rotateZ(90deg) correspondent, tandis que les dimensions de mise en page restent 80x20.

Exemples

const box=document.createElement('div');
box.style.cssText='position:absolute;left:200px;top:200px;width:80px;height:20px;transform-origin:0 0';
document.body.append(box);
for(const angle of [90,-90]){box.style.transform='rotateZ('+angle+'deg)';const matrix=new DOMMatrix(getComputedStyle(box).transform);const p=matrix.transformPoint(new DOMPoint(10,0));const r=box.getBoundingClientRect();console.log(angle+': point='+[p.x,p.y].map(v=>Math.round(v)).join(',')+'; bounds='+[r.x,r.y,r.width,r.height].map(v=>Math.round(v)).join(','))}
box.style.transform='rotate(90deg)';const a=getComputedStyle(box).transform;
box.style.transform='rotateZ(90deg)';
console.log('same-matrix='+String(a===getComputedStyle(box).transform)+'; layout='+box.offsetWidth+'x'+box.offsetHeight);

Résultat

90: point=0,10; bounds=180,200,20,80
-90: point=0,-10; bounds=200,120,20,80
same-matrix=true; layout=80x20

Les rotations positive et négative déplacent le rectangle englobant dans des directions différentes. Les dimensions de mise en page inchangées sont mesurées séparément de ce rectangle.

Sources