Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

translate — translação independente de um elemento

A propriedade translate desloca um elemento ao longo dos eixos X, Y e, opcionalmente, Z, independentemente de transform. Altera a posição visual, mas mantém o lugar do elemento na disposição.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

translate: none | <length-percentage> [ <length-percentage> <length>? ]?;

translate aceita valores X, Y e Z separados por espaços; as coordenadas omitidas equivalem a 0px. X e Y aceitam comprimentos e percentagens; Z aceita apenas um comprimento. As percentagens referem-se à largura e à altura da caixa de referência selecionada por transform-box.

O valor inicial é none e a propriedade não é herdada. Ao contrário de none, até translate: 0px cria um contexto de empilhamento e um bloco de referência para os descendentes. translate não substitui transform: quando não existe um percurso de movimento, a ordem de composição é translate, rotate, scale e, por fim, transform.

A translação não reposiciona os elementos vizinhos na disposição. No exemplo, 50% da largura de 100px desloca o elemento 50px para a direita; 10px desloca-o para baixo. O seu tamanho mantém-se inalterado.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>translate</title>
<style>
  body { margin: 0; }
  #box {
    width: 100px;
    height: 60px;
    background: teal;
    translate: 50% 10px;
  }
</style>
<div id="box"></div>
<pre id="result"></pre>
<script>
  const rect = document.querySelector('#box').getBoundingClientRect();
  document.querySelector('#result').textContent =
    `x=${rect.x}, y=${rect.y}, width=${rect.width}, height=${rect.height}`;
</script>

Resultado

x=50, y=10, width=100, height=60

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes