CKTIS / CSS
rotate3d(): směr osy a jediný úhel otočení
Normalizujte třísložkovou osu, ošetřete nulový vektor a zachovejte jasné pořadí prostorových otočení.
Verze: 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);První tři argumenty rotate3d() jsou čísla bez jednotek popisující směr osy; nejsou to tři úhly ani posunutí. Čtvrtý argument je jediný úhel nebo nula bez jednotky. Prohlížeč nenulovou osu normalizuje, takže vynásobení všech složek stejným kladným faktorem otočení nezmění. Vektor, který nelze normalizovat, například 0,0,0, způsobí, že toto otočení nemá účinek, místo aby zneplatnil celý seznam transformací.
Kladné otočení je při pohledu od kladného konce osy k počátku ve směru hodinových ručiček podle souřadnicové konvence CSS. transform-origin určuje bod, kterým osa prochází. Otočení kolem různých os obecně nejsou komutativní: jejich prohození může změnit výsledek. Výpočet otočení nepotřebuje perspektivu, perspektiva však mění jeho projekci; zachování společného trojrozměrného prostoru pro potomky je samostatná otázka.
Příklad používá vypočtené matice, nikoli vizuální odhad hloubky. Osy 0,0,1 a 0,0,5 převedou zkušební bod shodně na 0,10,0, zatímco nulová osa jej ponechá v 10,0,0. Opačné pořadí dvou zapsaných osových otočení dává pro stejný vstupní bod 1,0,0 nebo 0,-1,0. Délka typu 1px ve složce osy je odmítnuta, protože složky jsou čísla. Výpočet ověřuje chování matic, nikoli vykreslení s perspektivou či vztahy vnořených prvků.
Příklady
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();Výsledek
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
Prohlížeč provádí obě pořadí otočení na skutečných vypočtených maticích. Zaokrouhlení odstraní šum zobrazení desetinných čísel; nulová osa znamená otočení bez účinku, nikoli náhradní řešení chyby.