CKTIS / CSS
translate(): spostare un riquadro senza spostare il suo posto nel layout
Calcola le percentuali sul riquadro di riferimento e distingui posizione disegnata, layout e matrici CSSOM.
Versione: CSS Modules
Sintassi
transform-box: border-box; transform: translate(50%, 25%);translate(tx, ty) sposta il sistema di coordinate locale in orizzontale e verticale. Entrambi gli argomenti accettano lunghezze o percentuali; il secondo è facoltativo e vale zero per impostazione predefinita. Le lunghezze non nulle richiedono unità. Le percentuali orizzontali usano la larghezza del riquadro di riferimento della trasformazione, quelle verticali la sua altezza, non le dimensioni del genitore. transform-box sceglie questo riferimento, importante quando padding e bordi lo differenziano dal riquadro del contenuto.
Una trasformazione modifica il disegno senza riassegnare lo spazio dell’elemento nel flusso normale né spostare gli elementi fratelli successivi per fare posto. L’ordine conta: translate(10px,0) scale(2) e scale(2) translate(10px,0) producono traslazioni diverse. Questa funzione in transform è distinta dalla proprietà separata translate e dall’attributo SVG transform, la cui sintassi differisce. Una traslazione pura non richiede di modificare transform-origin.
L’esempio ha contenuto di 80px per 40px, padding di 10px e bordo di 5px, per un riquadro del bordo di 110px per 70px. La traslazione di 50% e 25% sposta i limiti disegnati di 55,17.5 con border-box e di 40,10 con content-box. In questa esecuzione di Chromium 157, la matrice calcolata serializzata continua a riportare 55,17.5 per content-box, nonostante lo spostamento misurato di 40,10. L’esempio stampa questa discrepanza invece di trattare la serializzazione CSSOM come geometria finale.
Il singolo argomento produce 12,0. Invertendo traslazione e scala, la traslazione della matrice passa da 10,0 a 20,0, mentre il fratello successivo si sposta di zero e le dimensioni di layout restano 110px per 70px. Usa getBoundingClientRect() quando serve il rettangolo trasformato nel viewport; distingui le sue coordinate dalle misure di layout e dalle coordinate locali della matrice.
Esempi
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();Risultato
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
Il confronto delle percentuali usa limiti misurati rispetto al genitore fisso. La discrepanza della matrice content-box è espressamente limitata al Chromium 157 verificato; non è la definizione CSS della traslazione percentuale.