CKTIS / CSS
rotate3d() : une direction d’axe et un angle unique
Normalisez un axe à trois composantes, traitez le vecteur nul et explicitez l’ordre des rotations spatiales.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
transform: rotate3d(0, 0, 1, 90deg);Les trois premiers arguments de rotate3d() sont des nombres sans unité qui indiquent la direction de l’axe, pas trois angles ni trois translations. Le quatrième est un angle ou un zéro sans unité. Le navigateur normalise un axe non nul : multiplier toutes ses composantes par un même facteur positif ne change pas la rotation. Un vecteur impossible à normaliser, comme 0,0,0, rend cette rotation sans effet au lieu d’invalider toute la liste.
Vue depuis l’extrémité positive de l’axe vers l’origine, une rotation positive est horaire selon la convention CSS. transform-origin indique le point traversé par l’axe. Les rotations autour d’axes différents ne commutent généralement pas : les inverser peut changer le résultat. La rotation se calcule sans perspective ; celle-ci change la projection. Préserver un espace tridimensionnel commun aux descendants constitue une question séparée.
L’exemple utilise des matrices calculées plutôt qu’une estimation visuelle de la profondeur. Les axes 0,0,1 et 0,0,5 envoient tous deux le point vers 0,10,0 ; l’axe nul le laisse à 10,0,0. Inverser les deux rotations d’axe donne 1,0,0 ou 0,-1,0 pour le même point. Une longueur telle que 1px dans l’axe est refusée car ses composantes sont des nombres. Le calcul vérifie les matrices, pas le rendu en perspective ni les interactions d’éléments imbriqués.
Exemples
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();Résultat
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
Le navigateur applique les deux ordres à de vraies matrices calculées. L’arrondi élimine les résidus d’affichage flottants ; l’axe nul est une rotation sans effet, pas une récupération après erreur.