Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

matrix3d(): jednorodne przekształcenie 3D

Zapisz transformację trójwymiarową przez szesnaście współczynników podanych kolumnami.

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

Składnia

transform: matrix3d(2,0,0,0, 0,3,0,0, 0,0,1,0, 10,20,30,1);

matrix3d() przyjmuje szesnaście współczynników jednorodnej macierzy przekształcenia 4 na 4. CSS zapisuje je kolumnami, a nie wierszami. W zwykłej transformacji afinicznej trzynasta, czternasta i piętnasta wartość oznaczają przesunięcia x, y oraz z. Przekątna może opisywać skalę, a pozostałe współczynniki obrót, ścinanie lub składniki związane z perspektywą.

Niezerowe przesunięcie z nie powiększa ani nie pomniejsza obiektu automatycznie. Perspektywę trzeba wprowadzić przez transformację lub odpowiedni kontekst perspective. Na wynik wpływa też transform-origin i otaczający kontekst renderowania 3D. Macierz faktycznie dwuwymiarowa może zostać uproszczona w zapisie przeglądarki; samo podanie szesnastu liczb nie gwarantuje widocznego efektu przestrzennego.

Przykład skaluje prostokąt 40 na 30 pikseli przez 2 i 3, a następnie przesuwa go o 10,20,30 macierzą bez perspektywy. DOMMatrix pokazuje trzy składniki przesunięcia i is2D równe false z powodu składowej z. Wyrenderowany prostokąt nadal ma 80 na 90, bez powiększenia perspektywicznego, a jego wymiary w normalnym układzie pozostają niezmienione.

Przykłady

const value='matrix3d(2,0,0,0, 0,3,0,0, 0,0,1,0, 10,20,30,1)';
const element=document.createElement('div');element.style.cssText='position:fixed;left:0;top:0;width:40px;height:30px;transform-origin:0 0';element.style.transform=value;document.body.append(element);
const rect=element.getBoundingClientRect();const matrix=new DOMMatrix(getComputedStyle(element).transform);
console.log('translation='+matrix.m41+','+matrix.m42+','+matrix.m43+'; rendered='+rect.width+'x'+rect.height+'; is2D='+matrix.is2D+'; perspective='+getComputedStyle(element).perspective);

Wynik

translation=10,20,30; rendered=80x90; is2D=false; perspective=none

Wartość z jest obecna w macierzy, mimo że rzut prostokątny na ekran nie zamienia jej w zmianę rozmiaru.

Źródła