WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scale3d(): unabhängige Skalierung auf drei Achsen

Ändere den Maßstab von X, Y und Z getrennt, ohne die Layoutgröße des Elements neu zu berechnen.

Version: 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) multipliziert Koordinaten entlang dreier Achsen. Alle drei durch Kommas getrennten Argumente sind erforderlich. Der Faktor 1 lässt die jeweilige Achse unverändert; ein negativer Faktor spiegelt sie. Prozentangaben stellen Faktoren dar: 50% bedeutet 0.5 und nicht die Hälfte einer Abmessung des Elternelements. Längen wie 2px sind keine Skalierungsfaktoren.

Das Element bleibt eine flache Ebene und wird nicht zu einem Körper mit Dicke. Die alleinige Skalierung von Z kann seine ungedrehte Fläche bei z=0 weder breiter noch höher machen. Der Z-Faktor ist für Punkte mit einer Tiefenverschiebung und beim Zusammensetzen von Drehungen, Verschiebungen oder Perspektive relevant. transform-origin legt den Bezugspunkt fest; die Reihenfolge der Funktionen verändert das zusammengesetzte Ergebnis.

Das Beispiel transformiert eine 40×30px große Box mit den Faktoren 2,3,4. Ihr sichtbares Rechteck misst 80×90px, während offsetWidth und offsetHeight bei 40×30 bleiben. Die berechnete Matrix bildet den Punkt (1,2,5) auf (2,6,20) ab. Die Prozentform ergibt die Diagonalfaktoren 0.5,1,1.5; die unvollständige Form mit zwei Argumenten wird abgelehnt.

Beispiele

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

Ergebnis

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

Gerenderte Abmessungen und Layoutabmessungen beantworten unterschiedliche Fragen. Die dritte Koordinate wird anhand der berechneten Matrix geprüft; das Beispiel unterstellt der Box keine körperliche Dicke.

Quellen