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

BCD tables only load in the browser

Siehe auch