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

CKTIS / CSS

translate3d() : trois coordonnées, avec d’autres règles pour la profondeur

Déplacez selon X, Y et Z en distinguant les références des pourcentages, la perspective et la mise en page inchangée.

Version : CSS Modules

Syntaxe

transform: perspective(240px) translate3d(0, 0, 60px);

translate3d(tx, ty, tz) demande trois composantes séparées par des virgules. X et Y acceptent des longueurs ou des pourcentages, calculés à partir de la largeur et de la hauteur de la boîte de référence de transformation. Z accepte une longueur, y compris zéro sans unité, mais aucun pourcentage puisqu’il n’existe pas de référence de profondeur correspondante. Dans le repère CSS habituel, Z positif pointe vers l’observateur.

Déplacer selon Z ne suffit pas à agrandir une boîte plane. La perspective fournit cette projection, et l’ordre des fonctions de perspective et de translation change le résultat. Des éléments imbriqués partageant une scène 3D peuvent aussi nécessiter transform-style: preserve-3d. Ce sont des contrôles distincts, pas des effets automatiques de translate3d(). Modifier le rendu n’agrandit pas la place dans le flux normal et ne garantit aucune accélération matérielle.

Pour une boîte de 80px sur 40px, translate3d(50%,25%,60px) donne le vecteur matriciel 40,10,60, alors que largeur et hauteur sans projection restent 80.00 sur 40.00. Avec perspective(240px) avant la translation de profondeur de 60px, les limites enregistrées atteignent 106.67 sur 53.33 ; inverser les fonctions les laisse à 80.00 sur 40.00. La mise en page reste de 80px sur 40px. L’exemple refuse une troisième composante absente et un Z en pourcentage ; il ne déplace pas la boîte sur le plan d’observation de la perspective ni derrière lui.

Exemples

const box=document.createElement('div');box.style.cssText='position:fixed;left:100px;top:100px;width:80px;height:40px;transform-origin:0 0;transform-box:border-box';document.body.append(box);
box.style.transform='translate3d(50%,25%,60px)';
const m=new DOMMatrix(getComputedStyle(box).transform);const plain=box.getBoundingClientRect();
box.style.transform='perspective(240px) translate3d(0,0,60px)';const projected=box.getBoundingClientRect();
box.style.transform='translate3d(0,0,60px) perspective(240px)';const reversed=box.getBoundingClientRect();
console.log('vector='+[m.m41,m.m42,m.m43]+'; plain='+plain.width.toFixed(2)+'x'+plain.height.toFixed(2));
console.log('projected='+projected.width.toFixed(2)+'x'+projected.height.toFixed(2)+'; reversed='+reversed.width.toFixed(2)+'x'+reversed.height.toFixed(2)+'; layout='+box.offsetWidth+'x'+box.offsetHeight);
console.log('missing-z='+CSS.supports('transform','translate3d(1px,2px)')+'; percent-z='+CSS.supports('transform','translate3d(0,0,50%)'));
box.remove();

Résultat

vector=40,10,60; plain=80.00x40.00
projected=106.67x53.33; reversed=80.00x40.00; layout=80x40
missing-z=false; percent-z=false

L’exemple utilise une origine de transformation nulle et une profondeur nettement inférieure à la distance de perspective de 240px. Les coordonnées de matrice sont locales ; les limites rendues et les dimensions de mise en page répondent à des questions différentes.

Sources