CKTIS / CSS
rotate3d(): una dirección de eje y un solo ángulo
Normaliza un eje de tres componentes, trata el vector cero y explicita el orden de los giros espaciales.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
transform: rotate3d(0, 0, 1, 90deg);Los tres primeros argumentos de rotate3d() son números sin unidad que describen la dirección del eje, no tres ángulos ni traslaciones. El cuarto es un ángulo o cero sin unidad. El navegador normaliza un eje no nulo: multiplicar todas sus componentes por el mismo factor positivo no cambia el giro. Un vector que no pueda normalizarse, como 0,0,0, hace que esa rotación no tenga efecto, sin invalidar toda la lista.
Mirando desde el extremo positivo del eje hacia el origen, un giro positivo es horario según la convención CSS. transform-origin fija el punto por el que pasa el eje. Las rotaciones sobre ejes distintos generalmente no conmutan: intercambiarlas puede cambiar el resultado. El giro se calcula sin perspectiva; esta cambia su proyección. Mantener un espacio tridimensional compartido por los descendientes es una cuestión aparte.
El ejemplo usa matrices calculadas, no una estimación visual de la profundidad. Los ejes 0,0,1 y 0,0,5 llevan el punto a 0,10,0, mientras el eje cero lo deja en 10,0,0. Invertir las dos rotaciones axiales da 1,0,0 o 0,-1,0 para el mismo punto inicial. Una longitud como 1px en el eje se rechaza porque sus componentes son números. Se comprueban matrices, no el dibujo en perspectiva ni las interacciones de elementos anidados.
Ejemplos
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
El navegador aplica ambos órdenes a matrices calculadas reales. El redondeo elimina residuos de coma flotante; el eje cero produce una rotación sin efecto, no una recuperación de errores.