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.