CKTIS / CSS
rotate3d(): eine Achsenrichtung und ein Drehwinkel
Normalisiere eine dreiteilige Achse, behandle den Nullvektor und beachte die Reihenfolge räumlicher Drehungen.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
transform: rotate3d(0, 0, 1, 90deg);Die ersten drei Argumente von rotate3d() sind einheitenlose Zahlen für die Achsenrichtung, keine drei Winkel oder Verschiebungen. Das vierte Argument ist ein Winkel oder eine einheitenlose Null. Der Browser normalisiert eine von null verschiedene Achse; alle Komponenten mit demselben positiven Faktor zu multiplizieren verändert die Drehung daher nicht. Eine nicht normalisierbare Achse wie 0,0,0 lässt diese Drehung wirkungslos, statt die ganze Transformationsliste ungültig zu machen.
Vom positiven Achsenende zum Ursprung gesehen verläuft eine positive Drehung nach der CSS-Konvention im Uhrzeigersinn. transform-origin bestimmt den Punkt, durch den die Achse läuft. Drehungen um unterschiedliche Achsen sind im Allgemeinen nicht vertauschbar. Ihre Berechnung benötigt keine Perspektive; Perspektive verändert die Projektion. Einen gemeinsamen dreidimensionalen Raum für Nachfahren zu erhalten ist ein eigenes Thema.
Das Beispiel verwendet berechnete Matrizen statt einer visuellen Vermutung über Tiefe. Die Achsen 0,0,1 und 0,0,5 bilden den Testpunkt beide auf 0,10,0 ab, die Nullachse lässt ihn bei 10,0,0. Die umgekehrte Reihenfolge der beiden Achsendrehungen ergibt für denselben Punkt 1,0,0 beziehungsweise 0,-1,0. Eine Länge wie 1px in der Achse wird abgelehnt, da ihre Komponenten Zahlen sein müssen. Geprüft wird das Matrixverhalten, nicht das perspektivische Zeichnen oder die Wechselwirkung verschachtelter Elemente.
Beispiele
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();Ergebnis
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
Beide Reihenfolgen werden auf echten berechneten Browsermatrizen ausgeführt. Gerundete Koordinaten entfernen Gleitkomma-Anzeigereste; die Nullachse ist eine wirkungslose Drehung, keine Fehlerbehandlung.