Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

rotate3d(): kierunek osi i jeden kąt obrotu

Normalizuj oś o trzech składowych, rozpoznaj wektor zerowy i jawnie ustal kolejność obrotów przestrzennych.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

transform: rotate3d(0, 0, 1, 90deg);

Pierwsze trzy argumenty rotate3d() to liczby bez jednostek opisujące kierunek osi; nie są trzema kątami ani przesunięciami. Czwarty argument jest jednym kątem albo zerem bez jednostki. Przeglądarka normalizuje niezerową oś, więc pomnożenie wszystkich składowych przez ten sam dodatni współczynnik nie zmienia obrotu. Wektor, którego nie da się znormalizować, na przykład 0,0,0, powoduje brak działania tego obrotu, zamiast unieważniać całą listę transformacji.

Patrząc od dodatniego końca osi ku początkowi układu, dodatni obrót jest zgodny z ruchem wskazówek zegara według konwencji współrzędnych CSS. transform-origin określa punkt, przez który przechodzi oś. Obroty wokół różnych osi na ogół nie są przemienne: zamiana kolejności może zmienić wynik. Obliczenie obrotu nie wymaga perspektywy, natomiast perspektywa zmienia rzutowanie; zachowanie wspólnej przestrzeni trójwymiarowej dla potomków jest osobnym zagadnieniem.

Przykład korzysta z obliczonych macierzy, a nie z wizualnego zgadywania głębi. Osie 0,0,1 i 0,0,5 przenoszą punkt do 0,10,0, natomiast oś zerowa pozostawia go w 10,0,0. Odwrócenie zapisanej kolejności dwóch obrotów osiowych daje dla tego samego punktu wejściowego 1,0,0 albo 0,-1,0. Długość taka jak 1px w osi zostaje odrzucona, ponieważ jej składowe są liczbami. Obliczenie sprawdza zachowanie macierzy, a nie rysowanie z perspektywą ani zależności zagnieżdżonych elementów.

Przykłady

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();

Wynik

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

Przeglądarka wykonuje obie kolejności obrotów na rzeczywistych obliczonych macierzach. Zaokrąglenie usuwa szum zapisu zmiennoprzecinkowego; zerowa oś daje obrót bez efektu, a nie zastępcze zachowanie po błędzie.

Źródła