WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

transform-origin — der Transformationsdrehpunkt

transform-origin legt den Punkt fest, um den ein Element gedreht oder skaliert wird. Zulässig sind Schlüsselwörter, Längen und Prozentwerte.

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

Syntax

transform-origin: [ left | center | right | top | bottom | <length-percentage> ] | [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ] <length>? | [ [ center | left | right ] && [ center | top | bottom ] ] <length>?;

transform-origin legt den Drehpunkt der Transformation fest; die Eigenschaft allein dreht ein Element nicht. Der Anfangswert ist 50% 50%, und die Eigenschaft wird nicht vererbt.

Bei einem einzelnen Wert bleibt die andere Koordinate auf center. Zwei numerische Werte geben zuerst X und dann Y an; ein optionaler dritter Wert legt Z fest und muss eine Länge sein, kein Prozentwert. Wird Z weggelassen, beträgt der Wert 0px. Die Schlüsselwörter left, center, right, top, bottom wählen die entsprechenden Kanten oder die Mitte aus; Paare von Achsen-Schlüsselwörtern können auch umgekehrt stehen, zum Beispiel top left.

Prozentwerte beziehen sich auf den durch transform-box ausgewählten Bezugsrahmen, nicht auf das Elternelement. Der Drehpunkt kann außerhalb dieses Rahmens liegen. Bei SVG-Elementen ohne zugehörige CSS-Layoutbox lautet der anfängliche verwendete Wert 0 0.

Das Beispiel dreht ein Rechteck um seine obere linke Ecke. Die Transformation ändert die Darstellung, führt aber nicht zu einem neuen Layout des umgebenden Inhalts.

Beispiele

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Transform origin</title>
<style>
  #frame {
    position: relative;
    margin: 48px;
    width: 80px;
    height: 40px;
    outline: 2px dashed #555;
  }
  #box {
    width: 100%;
    height: 100%;
    background: #1769aa;
    transform-box: border-box;
    transform-origin: left top;
    transform: rotate(90deg);
  }
</style>
</head>
<body>
<div id="frame" role="img" aria-label="Blue rectangle rotated 90 degrees clockwise about the upper-left corner of its original box, shown by a dashed outline.">
  <div id="box"></div>
</div>
<script>
  const frame = document.getElementById('frame').getBoundingClientRect();
  const box = document.getElementById('box');
  const rotated = box.getBoundingClientRect();
  const relativeX = x => Math.round(x - frame.left);
  const relativeY = y => Math.round(y - frame.top);
  console.log(`Computed transform-origin: ${getComputedStyle(box).transformOrigin}`);
  console.log(`Reference border box (outline excluded): x=0..${frame.width}, y=0..${frame.height}`);
  console.log(`Rotated border box relative to reference: x=${relativeX(rotated.left)}..${relativeX(rotated.right)}, y=${relativeY(rotated.top)}..${relativeY(rotated.bottom)}`);
</script>
</body>
</html>

Ergebnis

Computed transform-origin: 0px 0px
Reference border box (outline excluded): x=0..80, y=0..40
Rotated border box relative to reference: x=-40..0, y=0..80

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen