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

CKTIS / CSS

translate(): mover uma caixa sem mover o seu lugar na disposição

Calcule percentagens em relação à caixa de referência e distinga posição desenhada, disposição e matrizes CSSOM.

Versão: CSS Modules

Sintaxe

transform-box: border-box; transform: translate(50%, 25%);

translate(tx, ty) desloca o sistema de coordenadas local horizontal e verticalmente. Ambos os argumentos aceitam comprimentos ou percentagens; o segundo é opcional e vale zero por omissão. Os comprimentos diferentes de zero exigem unidades. As percentagens horizontais usam a largura da caixa de referência da transformação e as verticais a sua altura, não as dimensões do elemento ascendente. transform-box escolhe essa referência, o que importa quando o espaçamento interior e os contornos a diferenciam da caixa de conteúdo.

Uma transformação altera o desenho sem redistribuir o espaço do elemento no fluxo normal nem deslocar os elementos irmãos seguintes para criar espaço. A ordem importa: translate(10px,0) scale(2) e scale(2) translate(10px,0) produzem translações diferentes. Esta função em transform é distinta da propriedade independente translate e do atributo SVG transform, cuja sintaxe difere. Uma translação pura não exige alterar transform-origin.

O exemplo tem conteúdo de 80px por 40px, espaçamento interior de 10px e contorno de 5px, resultando numa caixa de contorno de 110px por 70px. A translação de 50% e 25% desloca os limites desenhados em 55,17.5 com border-box e 40,10 com content-box. Nesta execução do Chromium 157, a matriz calculada serializada continua a indicar 55,17.5 para content-box, apesar do deslocamento medido de 40,10. O exemplo apresenta essa discrepância em vez de tratar a serialização CSSOM como geometria final.

Um único argumento produz 12,0. Inverter translação e escala muda a translação da matriz de 10,0 para 20,0, enquanto o irmão seguinte se desloca zero e as dimensões de disposição permanecem 110px por 70px. Use getBoundingClientRect() quando precisar do retângulo transformado na área de visualização; distinga as suas coordenadas das medidas de disposição e das coordenadas locais da matriz.

Exemplos

const host=document.createElement('div');host.style.cssText='position:fixed;left:100px;top:100px;width:400px';
const box=document.createElement('div');box.style.cssText='width:80px;height:40px;padding:10px;border:5px solid;transform-box:border-box';
const sibling=document.createElement('div');sibling.style.height='10px';host.append(box,sibling);document.body.append(host);
const before=sibling.getBoundingClientRect().top;
const matrix=()=>{const m=new DOMMatrix(getComputedStyle(box).transform);return [m.m41,m.m42].join(',')};
const position=()=>{const r=box.getBoundingClientRect();return [r.left-100,r.top-100].join(',')};
box.style.transform='translate(50%,25%)';const border=position();
box.style.transformBox='content-box';const content=position();const reported=matrix();
box.style.transform='translate(12px)';const single=matrix();
box.style.transform='translate(10px,0) scale(2)';const first=matrix();
box.style.transform='scale(2) translate(10px,0)';const second=matrix();
console.log('border='+border+'; content='+content+'; content-matrix='+reported+'; single='+single);
console.log('order='+first+' / '+second+'; sibling-shift='+(sibling.getBoundingClientRect().top-before)+'; layout='+box.offsetWidth+'x'+box.offsetHeight);
console.log('nonzero-unitless='+CSS.supports('transform','translate(12,0)'));
host.remove();

Resultado

border=55,17.5; content=40,10; content-matrix=55,17.5; single=12,0
order=10,0 / 20,0; sibling-shift=0; layout=110x70
nonzero-unitless=false

A comparação das percentagens utiliza limites medidos em relação ao elemento ascendente fixo. A discrepância da matriz content-box limita-se expressamente ao Chromium 157 testado; não é a definição CSS de translação percentual.

Fontes