Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

translateX(): spostamento orizzontale e riferimento percentuale

Sposta il riquadro disegnato lungo X distinguendo la sua larghezza di riferimento da quella del genitore.

Versione: CSS Modules

Sintassi

transform: translateX(<length-percentage>);

All’interno di transform, translateX() aggiunge uno spostamento orizzontale senza cambiare la coordinata Y. I valori positivi seguono il verso positivo di X, quelli negativi il verso opposto; in una pagina normale non ruotata significa destra e sinistra. Usa una lunghezza, una percentuale o un’espressione calc() di tipo compatibile. Un numero senza unità diverso da zero, come 20, non è valido, mentre 0 è consentito. La proprietà separata translate è un’altra notazione, non la stessa dichiarazione.

Una percentuale si riferisce alla larghezza selezionata da transform-box, non automaticamente al genitore. Per un normale riquadro HTML, border-box comprende padding e bordi, mentre content-box usa la larghezza del contenuto. Una traslazione pura non cambia le dimensioni e non riserva un nuovo posto nel flusso normale. Quando è combinata con ridimensionamento o rotazione, conta l’ordine delle funzioni; per queste altre trasformazioni conta anche l’origine di riferimento.

Il riquadro misurato ha 80px di contenuto più 10px di padding e 5px di bordo per lato: 110px in totale, dentro un genitore di 500px. translateX(50%) lo sposta di 55px con border-box e di 40px con content-box. Un valore di -20px lo sposta a sinistra; calc(50% - 5px) produce 35px con content-box. Ripristinando border-box e l’origine 0 0, i due ordini di ridimensionamento e traslazione producono bordi sinistri a 10 e 20 con larghezza 220. Nel layout il bordo sinistro rimane a 0 e la larghezza a 110.

Esempi

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)'));

Risultato

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

Le terne stampate indicano bordo sinistro, bordo superiore e larghezza visibile. Il confronto dell’ordine ripristina esplicitamente border-box, affinché lo spostamento dell’origine di content-box non nasconda la differenza.

Fonti