Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

translateX() : déplacement horizontal et référence des pourcentages

Déplacez la boîte dessinée selon X en distinguant sa propre largeur de référence de celle de son parent.

Version : CSS Modules

Syntaxe

transform: translateX(<length-percentage>);

Dans transform, translateX() ajoute un déplacement horizontal sans changer la coordonnée Y. Les valeurs positives suivent le sens positif de X, les négatives le sens opposé ; sur une page ordinaire sans rotation, cela correspond à droite et à gauche. Utilisez une longueur, un pourcentage ou une expression calc() de type compatible. Un nombre sans unité non nul comme 20 est invalide, mais 0 est autorisé. La propriété séparée translate est une autre notation, pas la même déclaration.

Un pourcentage se rapporte à la largeur sélectionnée par transform-box, pas automatiquement au parent. Pour une boîte HTML ordinaire, border-box comprend le remplissage et les bordures, tandis que content-box utilise la largeur du contenu. Une translation seule ne change pas les dimensions et ne réserve pas une nouvelle place dans le flux normal. Lorsqu’elle est combinée à une mise à l’échelle ou à une rotation, l’ordre des fonctions compte ; le point d’origine importe aussi pour ces autres transformations.

La boîte mesurée possède 80px de contenu, plus 10px de remplissage et 5px de bordure de chaque côté : 110px au total, dans un parent de 500px. translateX(50%) la déplace de 55px avec border-box et de 40px avec content-box. Une valeur de -20px la déplace à gauche ; calc(50% - 5px) donne 35px avec content-box. En rétablissant border-box et l’origine 0 0, les deux ordres de mise à l’échelle et de translation donnent des bords gauches à 10 et 20, avec une largeur de 220. Dans la mise en page, le bord gauche reste à 0 et la largeur à 110.

Exemples

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

Résultat

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

Les triplets affichés indiquent le bord gauche, le bord supérieur et la largeur visible. La comparaison d’ordre rétablit explicitement border-box pour que le décalage d’origine de content-box ne masque pas la différence.

Sources