WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

translate — unabhängige Verschiebung eines Elements

Die Eigenschaft translate verschiebt ein Element unabhängig von transform entlang der X-, Y- und optional der Z-Achse. Sie ändert die visuelle Position, lässt den Platz des Elements im Layout jedoch unverändert.

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

Syntax

translate: none | <length-percentage> [ <length-percentage> <length>? ]?;

translate nimmt durch Leerzeichen getrennte Werte für X, Y und Z an; ausgelassene Koordinaten entsprechen 0px. Für X und Y sind Längen und Prozentwerte zulässig, für Z nur eine Länge. Prozentwerte beziehen sich auf Breite und Höhe des durch transform-box ausgewählten Bezugsrahmens.

Der Anfangswert ist none; die Eigenschaft wird nicht vererbt. Anders als none erzeugt selbst translate: 0px einen Stacking-Kontext und einen Containing Block für Nachfahren. translate ersetzt transform nicht: Ohne Motion Path ist die Reihenfolge der Kombination translate, rotate, scale und anschließend transform.

Die Verschiebung ordnet benachbarte Elemente im Layout nicht neu an. Im Beispiel verschiebt 50% der Breite von 100px das Element um 50px nach rechts; 10px verschieben es nach unten. Seine Größe bleibt unverändert.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>translate</title>
<style>
  body { margin: 0; }
  #box {
    width: 100px;
    height: 60px;
    background: teal;
    translate: 50% 10px;
  }
</style>
<div id="box"></div>
<pre id="result"></pre>
<script>
  const rect = document.querySelector('#box').getBoundingClientRect();
  document.querySelector('#result').textContent =
    `x=${rect.x}, y=${rect.y}, width=${rect.width}, height=${rect.height}`;
</script>

Ergebnis

x=50, y=10, width=100, height=60

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