translate()
Quick Summary for translate()
translate()
CSS function repositions an element in the horizontal and/or vertical directions. Its result is a <transform-function>
data type.
Code Usage for translate()
/* 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%);
More Details for translate()
translate()
The translate()
CSS function repositions an element in the horizontal and/or vertical directions. Its result is a <transform-function>
data type.
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 to 0
. For example, translate(2px)
is equivalent to translate(2px, 0)
. A percentage value refers to the width of the reference box defined by the transform-box
property.
<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 the transform-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. | ( 1 0 tx 0 1 ty 0 0 1 ) | ( 1 0 tx 0 1 ty 0 0 1 ) | ( 1 0 0 tx 0 1 0 ty 0 0 1 0 0 0 0 1 ) |
[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; }
ResultCombining 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; }
ResultSpecifications
Specification |
---|
CSS Transforms Module Level 1 # funcdef-transform-translate |
See also
transform
<transform-function>
Select your preferred language English (US)EspañolFrançais日本語Português (do Brasil)中文 (简体) Change language