translate()

{{CSSRef}} 

The translate() CSS function repositions an element in the horizontal and/or vertical directions. Its result is a {{cssxref("<transform-function>")}}  data type.

{{EmbedInteractiveExample("pages/css/function-translate.html")}} 

This transformation is characterized by a two-dimensional vector [tx, ty]. 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 {{cssxref("<length>")}}  or {{cssxref("<percentage>")}}  representing the abscissa (horizontal, x-component) of the translating vector [tx, 0]. The ordinate (vertical, y-component) 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 {{cssxref("transform-box")}}  property.
• Double <length-percentage> values
  • : This value describes two {{cssxref("<length>")}}  or {{cssxref("<percentage>")}}  values representing both the abscissa (horizontal, x-component) and the ordinate (vertical, y-component) of the translating vector [tx, ty]. A percentage as first value refers to the width, as second part to the height of the reference box defined by the {{cssxref("transform-box")}}  property.

Formal syntax

{{CSSSyntax}} 

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 {
  /* Equal to: translateX(10px) or translate(10px, 0) */
  transform: translate(10px);
  background-color: pink;
}

Result

{{EmbedLiveSample("Using_a_single-axis_translation", 250, 250)}} 

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

{{EmbedLiveSample("Combining_y-axis_and_x-axis_translation", 250, 250)}} 

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• {{cssxref("transform")}} 
• {{cssxref("<transform-function>")}} 
• {{cssxref("translate")}}