CKTIS / CSS
translateX(): desplazamiento horizontal y referencia porcentual
Mueve la caja dibujada por el eje X distinguiendo su propia anchura de referencia de la anchura del padre.
Versión: CSS Modules
Sintaxis
transform: translateX(<length-percentage>);Dentro de transform, translateX() añade un desplazamiento horizontal sin cambiar la coordenada Y. Los valores positivos avanzan en el sentido positivo de X y los negativos en el contrario; en una página normal sin rotación, esto significa derecha e izquierda. Usa una longitud, un porcentaje o una expresión calc() de tipo compatible. Un número sin unidad distinto de cero, como 20, es inválido, mientras que 0 está permitido. La propiedad independiente translate es otra notación, no la misma declaración.
Un porcentaje se refiere a la anchura elegida mediante transform-box, no automáticamente al padre. En una caja HTML normal, border-box incluye relleno y bordes, mientras que content-box usa la anchura del contenido. Una traslación pura no cambia las dimensiones ni reserva un nuevo lugar en el flujo normal. Al combinarla con escalado o rotación importa el orden de las funciones; el origen de referencia también importa para esas otras transformaciones.
La caja medida tiene 80px de contenido más 10px de relleno y 5px de borde a cada lado: 110px en total, dentro de un padre de 500px. translateX(50%) la desplaza 55px con border-box y 40px con content-box. Un valor de -20px la mueve a la izquierda; calc(50% - 5px) produce 35px con content-box. Al restablecer border-box y el origen 0 0, los dos órdenes de escalado y traslación generan bordes izquierdos en 10 y 20 y una anchura de 220. En la distribución, el borde izquierdo sigue en 0 y la anchura en 110.
Ejemplos
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
Las ternas impresas indican borde izquierdo, borde superior y anchura visible. La comparación del orden restablece explícitamente border-box para que el desplazamiento del origen de content-box no oculte la diferencia.