---
title: translate()
slug: Web/CSS/transform-function/translate
tags:
  - CSS
  - Função CSS
  - Referencia
  - Transformações CSS
translation_of: Web/CSS/transform-function/translate()
original_slug: Web/CSS/transform-function/translate()
---
<div>{{CSSRef}}</div>

<p>A função <a href="/en-US/docs/Web/CSS">CSS</a> <strong><code>translate()</code></strong> reposiciona um elemento na direção horizontal e/ou vertical. O seu resultado é um tipo de dado {{cssxref("&lt;transform-function&gt;")}}.</p>

<p><img alt="" src="https://mdn.mozillademos.org/files/12121/translate.png" style="height: 195px; width: 249px;"></p>

<p>Esta transformação é caracterizada por um vetor bidimensional. Suas coordenadas definem o quanto o elemento se move em cada direção.</p>

<h2 id="Sintaxe">Sintaxe</h2>

<pre class="brush: css notranslate">/* Valores &lt;length-percentage&gt; únicos */
transform: translate(200px);
transform: translate(50%);

/* Valores &lt;length-percentage&gt; duplos */
transform: translate(100px, 200px);
transform: translate(100px, 50%);
transform: translate(30%, 200px);
transform: translate(30%, 50%);
</pre>

<h3 id="Valores">Valores</h3>

<dl>
 <dt>Valores <code>&lt;length-percentage&gt;</code> únicos</dt>
 <dd>Este valor é um {{cssxref("length")}} ou {{cssxref("percentage")}} representando a abcissa (horizontal, coordenada x) do vetor de translação. A ordenada (vertical, coordenada y) do vetor de translação será definida como <code>0</code>. Por exemplo, <code>translate(2)</code> é equivalente a <code>translate(2, 0)</code>. Um valor percentual refere-se à largura da caixa de referência definida pela propriedade {{cssxref("transform-box")}}.</dd>
 <dt>Valores <code>&lt;length-percentage&gt;</code> duplos</dt>
 <dd>Este valor descreve dois {{cssxref("length")}} ou valores {{cssxref("percentage")}} representando tanto a abcissa (coordenada x) quanto a ordenada (coordenada y) do vetor de translação. Uma porcentagem como primeiro valor refere-se à largura, como segunda parte da altura da caixa de referência definida pela propedade {{cssxref("transform-box")}}.</dd>
</dl>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Coordenadas cartesianas em ℝ<sup>2</sup></th>
   <th scope="col">Coordenadas homogêneas emℝℙ<sup>2</sup></th>
   <th scope="col">Coordenadas cartesianas em ℝ<sup>3</sup></th>
   <th scope="col">Coordenadas homogêneas em ℝℙ<sup>3</sup></th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td colspan="1" rowspan="2">
    <p>Uma translação não é uma transformação linear em ℝ<sup>2</sup> e não pode ser representada usando uma matriz de coordenadas cartesianas.</p>
   </td>
   <td><math> <mfenced><mtable><mtr>1<mtd>0</mtd><mtd>tx</mtd></mtr><mtr>0<mtd>1</mtd><mtd>ty</mtd></mtr><mtr><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr></mtable> </mfenced> </math></td>
   <td colspan="1" rowspan="2"><math> <mfenced><mtable><mtr>1<mtd>0</mtd><mtd>tx</mtd></mtr><mtr>0<mtd>1</mtd><mtd>ty</mtd></mtr><mtr><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr></mtable> </mfenced> </math></td>
   <td colspan="1" rowspan="2"><math> <mfenced><mtable><mtr>1<mtd>0</mtd><mtd>0</mtd><mtd>tx</mtd></mtr><mtr>0<mtd>1</mtd><mtd>0</mtd><mtd>ty</mtd></mtr><mtr><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd><mtd>0</mtd></mtr><mtr><mtd>0</mtd><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr></mtable> </mfenced> </math></td>
  </tr>
  <tr>
   <td><code>[1 0 0 1 tx ty]</code></td>
  </tr>
 </tbody>
</table>

<h3 id="Sintaxe_formal">Sintaxe formal</h3>

<pre class="syntaxbox notranslate">translate({{cssxref("length-percentage")}} , {{cssxref("length-percentage")}}<a href="/en-US/docs/Web/CSS/Value_definition_syntax#Question_mark_()">?</a>)
</pre>

<h2 id="Exemplos">Exemplos</h2>

<h3 id="Usando_uma_conversão_de_eixo_único">Usando uma conversão de eixo único</h3>

<h4 id="HTML">HTML</h4>

<pre class="brush: html notranslate">&lt;div&gt;Estático&lt;/div&gt;
&lt;div class="moved"&gt;Movido&lt;/div&gt;
&lt;div&gt;Estático&lt;/div&gt;</pre>

<h4 id="CSS">CSS</h4>

<pre class="brush: css notranslate">div {
  width: 60px;
  height: 60px;
  background-color: skyblue;
}

.moved {
  transform: translate(10px); /* Igual a: translateX(10px) ou translate(10px, 0) */
  background-color: pink;
}
</pre>

<h4 id="Resultado">Resultado</h4>

<p>{{EmbedLiveSample("Using_a_single-axis_translation", 250, 250)}}</p>

<h3 id="Combinando_a_translação_do_eixo_y_e_do_eixo_x">Combinando a translação do eixo y e do eixo x</h3>

<h4 id="HTML_2">HTML</h4>

<pre class="brush: html notranslate">&lt;div&gt;Estático&lt;/div&gt;
&lt;div class="moved"&gt;Movido&lt;/div&gt;
&lt;div&gt;Estático&lt;/div&gt;</pre>

<h4 id="CSS_2">CSS</h4>

<pre class="brush: css notranslate">div {
  width: 60px;
  height: 60px;
  background-color: skyblue;
}

.moved {
  transform: translate(10px, 10px);
  background-color: pink;
}
</pre>

<h4 id="Resultado_2">Resultado</h4>

<p>{{EmbedLiveSample("Combining_y-axis_and_x-axis_translation", 250, 250)}}</p>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificações</th>
   <th scope="col">Estado</th>
   <th scope="col">Comentário</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSS3 Transforms', '#funcdef-transform-translate', 'translate()')}}</td>
   <td>{{Spec2('CSS3 Transforms')}}</td>
   <td>Definição inicial</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>Verifique o tipo de dado <code><a href="/en-US/docs/Web/CSS/transform-function#Browser_compatibility">&lt;transform-function&gt;</a></code> para informações de compatibilidade.</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li>{{cssxref("transform")}}</li>
 <li>{{cssxref("&lt;transform-function&gt;")}}</li>
</ul>