KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

scale3d(): onafhankelijke schaalfactoren voor drie assen

Wijzig de schaal van X, Y en Z afzonderlijk zonder de layoutafmetingen van het element opnieuw te berekenen.

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

Syntax

transform: scale3d(2, 3, 4);

scale3d(sx, sy, sz) vermenigvuldigt coördinaten langs drie assen. Alle drie de door komma’s gescheiden argumenten zijn verplicht. Een factor 1 laat zijn as ongewijzigd; een negatieve factor spiegelt die as. Percentages stellen factoren voor: 50% betekent dus 0.5 en niet de helft van de afmetingen van het bovenliggende element. Lengtes zoals 2px zijn geen schaalfactoren.

Het element blijft een plat vlak, geen massief object met dikte. Alleen Z schalen kan het niet-geroteerde oppervlak op z=0 niet breder of hoger maken. De Z-factor is relevant voor punten die in de diepte zijn verplaatst en voor combinaties met rotaties, verplaatsingen of perspectief. transform-origin bepaalt het referentiepunt; de volgorde van functies verandert het samengestelde resultaat.

Het voorbeeld transformeert een vak van 40×30px met de factoren 2,3,4. De zichtbare rechthoek is 80×90px, terwijl offsetWidth en offsetHeight 40×30 blijven. De berekende matrix zet het punt (1,2,5) om in (2,6,20). De procentuele vorm levert diagonale factoren 0.5,1,1.5 op en de onvolledige vorm met twee argumenten wordt afgewezen.

Voorbeelden

const box=document.createElement('div');
box.style.cssText='position:fixed;left:60px;top:60px;width:40px;height:30px;transform-origin:0 0;transform:scale3d(2,3,4)';
document.body.append(box);
const rect=box.getBoundingClientRect();
const matrix=new DOMMatrix(getComputedStyle(box).transform);
const point=matrix.transformPoint(new DOMPoint(1,2,5));
box.style.transform='scale3d(50%,100%,150%)';
const percentages=new DOMMatrix(getComputedStyle(box).transform);
console.log('rendered='+rect.width+'x'+rect.height+'; layout='+box.offsetWidth+'x'+box.offsetHeight+'; point='+[point.x,point.y,point.z]+'; percentages='+[percentages.m11,percentages.m22,percentages.m33]+'; missing-z='+CSS.supports('transform','scale3d(2,3)'));

Resultaat

rendered=80x90; layout=40x30; point=2,6,20; percentages=0.5,1,1.5; missing-z=false

Gerenderde afmetingen en layoutafmetingen beantwoorden verschillende vragen. De derde coördinaat wordt via de berekende matrix gecontroleerd; het voorbeeld doet niet alsof het vak fysieke dikte heeft.

Bronnen