Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

rotateZ(): rodar no plano do ecrã

Usa o eixo Z para uma rotação plana mantendo a caixa original da disposição.

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

Sintaxe

transform: rotateZ(90deg);

A função rotateZ() roda em torno do eixo Z local, que aponta para fora do ecrã no sistema CSS habitual. O ângulo produz a mesma transformação geométrica que rotate(). Com X para a direita e Y para baixo, um ângulo positivo de 90deg roda um ponto à direita para baixo; -90deg roda-o para cima. O ponto de rotação vem de transform-origin e não tem de ser o canto superior esquerdo.

Uma rotação altera a forma desenhada e o seu retângulo delimitador na janela, não as dimensões utilizadas pelo fluxo normal. Os elementos vizinhos podem, por isso, sobrepor-se. As funções de transformação compõem-se por ordem: uma translação antes ou depois de uma rotação pode deslocar a caixa de maneira diferente. Não deduzas dimensões de disposição a partir do retângulo que envolve um elemento rodado, nem esperes que rotateZ() crie perspetiva.

O exemplo fixa o ponto de rotação no canto superior esquerdo de uma caixa de 80px por 20px posicionada em 200px,200px. Com 90deg, o retângulo delimitador é 180,200,20,80; com -90deg, é 200,120,20,80. O ponto local 10,0 passa a 0,10 ou 0,-10. Por fim, as matrizes calculadas para rotate(90deg) e rotateZ(90deg) coincidem, enquanto as dimensões de disposição permanecem em 80x20.

Exemplos

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);

Resultado

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

As rotações positiva e negativa deslocam o retângulo delimitador em direções diferentes. As dimensões de disposição inalteradas são medidas separadamente desse retângulo.

Fontes