The translate()
CSS function repositions an element in the horizontal and/or vertical directions. Its result is a <transform-function>
data type.
[[File:../../../../../../media.prod.mdn.mozit.cloud/attachments/2015/12/14/12121/db685cb3d863b64e60429a855105b540/translate.png]]
This transformation is characterized by a two-dimensional vector. Its coordinates define how much the element moves in each direction.
Syntax
/* Single <length-percentage> values */
transform: translate(200px);
transform: translate(50%);
/* Double <length-percentage> values */
transform: translate(100px, 200px);
transform: translate(100px, 50%);
transform: translate(30%, 200px);
transform: translate(30%, 50%);
Values
- Single
<length-percentage>
values - This value is a
<length>
or<percentage>
representing the abscissa (horizontal, x-coordinate) of the translating vector. The ordinate (vertical, y-coordinate) of the translating vector will be set to0
. For example,translate(2)
is equivalent totranslate(2, 0)
. A percentage value refers to the width of the reference box defined by thetransform-box
property. - Double
<length-percentage>
values - This value describes two
<length>
or<percentage>
values representing both the abscissa (x-coordinate) and the ordinate (y-coordinate) of the translating vector. A percentage as first value refers to the width, as second part to the height of the reference box defined by thetransform-box
property.
Cartesian coordinates on ℝ2 | Homogeneous coordinates on ℝℙ2 | Cartesian coordinates on ℝ3 | Homogeneous coordinates on ℝℙ3 |
---|---|---|---|
A translation is not a linear transformation in ℝ2 and can't be represented using a Cartesian-coordinate matrix. | <math display="inline">\begin{pmatrix}
& & \\ & & \\ & & \\ \end{pmatrix}</math> |
<math display="inline">\begin{pmatrix}
& & \\ & & \\ & & \\ \end{pmatrix}</math> |
<math display="inline">\begin{pmatrix}
& & & \\ & & & \\ & & & \\ & & & \\ \end{pmatrix}</math> |
[1 0 0 1 tx ty]
|
Formal syntax
translate(<length-percentage> , <length-percentage>?)
Examples
Using a single-axis translation
HTML
<div>Static</div>
<div class="moved">Moved</div>
<div>Static</div>
CSS
div {
width: 60px;
height: 60px;
background-color: skyblue;
}
.moved {
transform: translate(10px); /* Equal to: translateX(10px) or translate(10px, 0) */
background-color: pink;
}
Result
Combining y-axis and x-axis translation
HTML
<div>Static</div>
<div class="moved">Moved</div>
<div>Static</div>
CSS
div {
width: 60px;
height: 60px;
background-color: skyblue;
}
.moved {
transform: translate(10px, 10px);
background-color: pink;
}
Result
Specifications
Specification | Status | Comment |
---|---|---|
CSS Transforms Level 1The definition of 'translate()' in that specification. | Working Draft | Initial definition |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
<transform-function>
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox Full support 3.5 |
IE Full support 9 Full support 9 Notes' Internet Explorer 9 supports 2D but not 3D transforms. In version 9, mixing 2D and 3D transform functions invalidates the entire property. |
Opera
Full support 10.5 |
Safari
Full support 3.1 |
WebView Android
Full support 2 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 11 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
3D support | Chrome
Full support 12 |
Edge
Full support 12 |
Firefox
Full support 10 |
IE
Full support 10 |
Opera
Full support 15 |
Safari
Full support 4 |
WebView Android
Full support 3 |
Chrome Android
Full support 18 |
Firefox Android
Full support 10 |
Opera Android
Full support 14 |
Safari iOS
Full support 3.2 |
Samsung Internet Android
Full support 1.0 |
Legend
- Full support
- Full support
- See implementation notes.'
- See implementation notes.
See also
translate() by Mozilla Contributors is licensed under CC-BY-SA 2.5.