CKTIS / CSS
rotate3d(): una direzione dell’asse e un solo angolo
Normalizza un asse a tre componenti, gestisci il vettore nullo e rendi esplicito l’ordine delle rotazioni spaziali.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
transform: rotate3d(0, 0, 1, 90deg);I primi tre argomenti di rotate3d() sono numeri senza unità che descrivono la direzione dell’asse, non tre angoli o traslazioni. Il quarto è un angolo o zero senza unità. Il browser normalizza un asse non nullo: moltiplicarne tutte le componenti per lo stesso fattore positivo non cambia la rotazione. Un vettore non normalizzabile, come 0,0,0, rende questa rotazione ininfluente invece di invalidare tutta la lista.
Guardando dall’estremità positiva dell’asse verso l’origine, una rotazione positiva è oraria secondo la convenzione CSS. transform-origin indica il punto attraversato dall’asse. Le rotazioni intorno ad assi diversi generalmente non commutano: invertirle può cambiare il risultato. Il calcolo non richiede prospettiva, che modifica invece la proiezione. Mantenere uno spazio tridimensionale comune ai discendenti è una questione distinta.
L’esempio usa matrici calcolate, non una supposizione visiva sulla profondità. Gli assi 0,0,1 e 0,0,5 portano entrambi il punto a 0,10,0; l’asse nullo lo lascia a 10,0,0. Invertire le due rotazioni assiali produce 1,0,0 oppure 0,-1,0 per lo stesso punto iniziale. Una lunghezza come 1px nell’asse viene rifiutata perché le componenti devono essere numeri. Si verifica il comportamento delle matrici, non il disegno prospettico o le interazioni tra elementi annidati.
Esempi
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();Risultato
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
Il browser applica entrambi gli ordini a vere matrici calcolate. L’arrotondamento elimina residui di rappresentazione floating point; l’asse nullo dà una rotazione senza effetto, non un ripiego dopo un errore.