CKTIS / CSS
translateX(): deslocamento horizontal e referência percentual
Desloca a caixa desenhada ao longo de X, distinguindo a sua própria largura de referência da largura do elemento pai.
Versão: CSS Modules
Sintaxe
transform: translateX(<length-percentage>);Dentro de transform, translateX() acrescenta um deslocamento horizontal sem alterar a coordenada Y. Os valores positivos seguem o sentido positivo de X e os negativos o sentido contrário; numa página normal sem rotação, isto significa direita e esquerda. Usa um comprimento, uma percentagem ou uma expressão calc() de tipo compatível. Um número sem unidade diferente de zero, como 20, é inválido, enquanto 0 é permitido. A propriedade separada translate é outra notação, não a mesma declaração.
Uma percentagem refere-se à largura escolhida por transform-box, não automaticamente ao elemento pai. Numa caixa HTML normal, border-box inclui o preenchimento e as bordas, enquanto content-box usa a largura do conteúdo. Uma translação pura não altera as dimensões nem reserva um novo lugar no fluxo normal. Quando é combinada com escala ou rotação, a ordem das funções importa; o ponto de origem também importa para essas outras transformações.
A caixa medida tem 80px de conteúdo, mais 10px de preenchimento e 5px de borda de cada lado: 110px no total, dentro de um elemento pai de 500px. translateX(50%) desloca-a 55px com border-box e 40px com content-box. Um valor de -20px desloca-a para a esquerda; calc(50% - 5px) produz 35px com content-box. Ao repor border-box e a origem 0 0, as duas ordens de escala e translação produzem limites esquerdos em 10 e 20, com largura 220. No esquema de disposição, o limite esquerdo continua em 0 e a largura em 110.
Exemplos
document.body.style.margin='0';
const parent=document.createElement('div');
parent.style.cssText='width:500px;height:200px';
const box=document.createElement('div');
box.style.cssText='width:80px;height:30px;padding:10px;border:5px solid;transform-box:border-box';
parent.append(box);document.body.append(parent);
const measure=value=>{box.style.transform=value;const r=box.getBoundingClientRect();return [r.left,r.top,r.width].join(',')};
const border=measure('translateX(50%)');
box.style.transformBox='content-box';
const content=measure('translateX(50%)');
const negative=measure('translateX(-20px)');
const calc=measure('translateX(calc(50% - 5px))');
box.style.transformBox='border-box';box.style.transformOrigin='0 0';const first=measure('translateX(10px) scaleX(2)');
const second=measure('scaleX(2) translateX(10px)');
console.log('border='+border+'; content='+content+'; negative='+negative+'; calc='+calc+'; orders='+first+' / '+second+'; layout='+box.offsetLeft+','+box.offsetWidth+'; unitless='+CSS.supports('transform','translateX(20)'));Resultado
border=55,0,110; content=40,0,110; negative=-20,0,110; calc=35,0,110; orders=10,0,220 / 20,0,220; layout=0,110; unitless=false
Os trios apresentados indicam o limite esquerdo, o limite superior e a largura visível. A comparação da ordem repõe explicitamente border-box para que o desvio da origem de content-box não esconda a diferença.