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

CKTIS / CSS

rotateY(): rodar em torno do eixo vertical

Roda uma caixa em profundidade e distingue a largura projetada da largura usada na 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: rotateY(60deg);

A função rotateY() roda em torno do eixo Y local; transform-origin define o ponto de rotação. Aceita um ângulo como 60deg e também 0 sem unidade. Nas coordenadas CSS habituais, X positivo aponta para a direita e Z positivo para o observador. Um quarto de volta positivo leva um ponto do eixo X positivo para Z negativo; um quarto de volta negativo leva-o para o observador.

A rotação já é tridimensional sem perspetiva, mas a sua projeção pode parecer apenas mais estreita. A perspetiva acrescenta um encurtamento dependente da profundidade. Faces aninhadas podem precisar de transform-style: preserve-3d; backface-visibility controla se uma face virada ao contrário é desenhada. São escolhas separadas, não efeitos automáticos de chamar rotateY(). A ordem das transformações importa e a caixa transformada não reorganiza o conteúdo circundante no fluxo normal.

O exemplo lê a matriz de transformação real: um ponto situado 100 unidades à direita passa a 0,0,-100 com 90deg e a 0,0,100 com -90deg. Sem perspetiva, 60deg projeta uma caixa de 100px de largura em 50px. A largura de disposição mantém-se em 100px. A saída arredondada evita ruído de vírgula flutuante; os pontos descrevem coordenadas locais, não posições na janela.

Exemplos

const box=document.createElement('div');
box.style.cssText='position:absolute;left:200px;top:200px;width:100px;height:40px;transform-origin:0 0';
document.body.append(box);
const point=angle=>{box.style.transform='rotateY('+angle+'deg)';const matrix=new DOMMatrix(getComputedStyle(box).transform);const p=matrix.transformPoint(new DOMPoint(100,0,0));return [p.x,p.y,p.z].map(v=>Math.round(v)).join(',')};
console.log('positive='+point(90)+'; negative='+point(-90));
box.style.transform='rotateY(60deg)';
console.log('visual-width='+Math.round(box.getBoundingClientRect().width)+'; layout-width='+box.offsetWidth+'; perspective='+getComputedStyle(box).perspective);

Resultado

positive=0,0,-100; negative=0,0,100
visual-width=50; layout-width=100; perspective=none

A comparação das larguras mostra uma projeção sem perspetiva. Outro ponto de rotação ou uma transformação de perspetiva adicional altera a geometria; a largura de disposição não é a largura projetada.

Fontes