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

CKTIS / CSS

rotate3d(): uma direção de eixo e um único ângulo

Normalize um eixo de três componentes, trate o vetor nulo e explicite a ordem das rotações espaciais.

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

Sintaxe

transform: rotate3d(0, 0, 1, 90deg);

Os três primeiros argumentos de rotate3d() são números sem unidade que descrevem a direção do eixo, não três ângulos nem translações. O quarto é um ângulo ou zero sem unidade. O navegador normaliza um eixo não nulo: multiplicar todas as componentes pelo mesmo fator positivo não altera a rotação. Um vetor que não possa ser normalizado, como 0,0,0, torna esta rotação inoperante em vez de invalidar toda a lista.

Olhando da extremidade positiva do eixo para a origem, uma rotação positiva segue os ponteiros do relógio segundo a convenção CSS. transform-origin determina o ponto atravessado pelo eixo. As rotações em eixos diferentes geralmente não comutam: trocá-las pode alterar o resultado. O cálculo não exige perspetiva, que altera a projeção. Preservar um espaço tridimensional comum aos descendentes é uma questão separada.

O exemplo usa matrizes calculadas, não uma suposição visual sobre profundidade. Os eixos 0,0,1 e 0,0,5 levam ambos o ponto a 0,10,0; o eixo nulo deixa-o em 10,0,0. Inverter as duas rotações axiais dá 1,0,0 ou 0,-1,0 para o mesmo ponto inicial. Um comprimento como 1px no eixo é rejeitado porque as componentes são números. Verifica-se o comportamento matricial, não a pintura em perspetiva nem as interações entre elementos aninhados.

Exemplos

const box = document.createElement('div');
document.body.append(box);
function point(transform, x, y, z) {
  box.style.transform = transform;
  const p = new DOMMatrix(getComputedStyle(box).transform).transformPoint(new DOMPoint(x,y,z));
  return [p.x,p.y,p.z].map(n => Number(n.toFixed(6))).join(',');
}
console.log('unit z axis:', point('rotate3d(0,0,1,90deg)',10,0,0));
console.log('scaled z axis:', point('rotate3d(0,0,5,90deg)',10,0,0));
console.log('zero axis:', point('rotate3d(0,0,0,90deg)',10,0,0));
console.log('X then Y list:', point('rotate3d(1,0,0,90deg) rotate3d(0,1,0,90deg)',0,0,1));
console.log('Y then X list:', point('rotate3d(0,1,0,90deg) rotate3d(1,0,0,90deg)',0,0,1));
console.log('length in axis:', CSS.supports('transform', 'rotate3d(1px,0,0,90deg)'));
box.remove();

Resultado

unit z axis: 0,10,0
scaled z axis: 0,10,0
zero axis: 10,0,0
X then Y list: 1,0,0
Y then X list: 0,-1,0
length in axis: false

O navegador aplica ambas as ordens a matrizes calculadas reais. O arredondamento elimina resíduos de vírgula flutuante; o eixo nulo resulta numa rotação sem efeito, não numa recuperação após erro.

Fontes