translate3d()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.

Die translate3d() CSS Funktion positioniert ein Element im 3D-Raum neu. Ihr Ergebnis ist ein <transform-function> Datentyp.

Probieren Sie es aus

Diese Transformation wird durch einen dreidimensionalen Vektor [tx, ty, tz] charakterisiert. Dessen Koordinaten definieren, um wie viel sich das Element in jede Richtung bewegt.

Syntax

css
translate3d(tx, ty, tz)

Werte

tx

Ist eine <length> oder <percentage>, die die Abszisse (horizontal, x-Komponente) des Translationsvektors [tx, ty, tz] repräsentiert.

ty

Ist eine <length> oder <percentage>, die die Ordinate (vertikal, y-Komponente) des Translationsvektors [tx, ty, tz] repräsentiert.

tz

Ist eine <length>, die die z-Komponente des Translationsvektors darstellt. Sie kann keinen <percentage> Wert haben; in diesem Fall wird die Eigenschaft, die die Transformation enthält, als ungültig angesehen [tx, ty, tz].

Kartesische Koordinaten auf ℝ^2 Homogene Koordinaten auf ℝℙ^2 Kartesische Koordinaten auf ℝ^3 Homogene Koordinaten auf ℝℙ^3

Diese Transformation gilt für den 3D-Raum und kann nicht auf der Ebene dargestellt werden.

Eine Translation ist keine lineare Transformation in ℝ^3 und kann nicht mit einer kartesischen Koordinatenmatrix dargestellt werden.
(100tx010ty001tz0001)\left( \begin{array}{cccc} 1 & 0 & 0 & tx \\ 0 & 1 & 0 & ty \\ 0 & 0 & 1 & tz \\ 0 & 0 & 0 & 1 \end{array} \right)

Formale Syntax

<translate3d()> = 
translate3d( <length-percentage> , <length-percentage> , <length> )

<length-percentage> =
<length> |
<percentage>

Beispiele

Verwendung einer einfachen Achsenübersetzung

HTML

html
<div>Static</div>
<div class="moved">Moved</div>
<div>Static</div>

CSS

css
div {
  width: 60px;
  height: 60px;
  background-color: skyblue;
}

.moved {
  /* Equivalent to perspective(500px) translateX(10px) */
  transform: perspective(500px) translate3d(10px, 0, 0px);
  background-color: pink;
}

Ergebnis

Kombination von z-Achsen- und x-Achsen-Übersetzung

HTML

html
<div>Static</div>
<div class="moved">Moved</div>
<div>Static</div>

CSS

css
div {
  width: 60px;
  height: 60px;
  background-color: skyblue;
}

.moved {
  transform: perspective(500px) translate3d(10px, 0, 100px);
  background-color: pink;
}

Ergebnis

Spezifikationen

Specification
CSS Transforms Module Level 2
# funcdef-translate3d

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
translate3d()

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch