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

CKTIS / CSS

translate — translation indépendante d’un élément

La propriété translate déplace un élément sur les axes X, Y et, éventuellement, Z, indépendamment de transform. Elle modifie sa position visuelle tout en conservant sa place dans la mise en page.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

translate: none | <length-percentage> [ <length-percentage> <length>? ]?;

translate accepte des valeurs X, Y et Z séparées par des espaces ; les coordonnées omises valent 0px. X et Y acceptent des longueurs et des pourcentages ; Z accepte uniquement une longueur. Les pourcentages se rapportent à la largeur et à la hauteur de la boîte de référence choisie par transform-box.

Sa valeur initiale est none et la propriété n’est pas héritée. Contrairement à none, même translate: 0px crée un contexte d’empilement et un bloc conteneur pour les descendants. translate ne remplace pas transform : en l’absence de chemin de déplacement, l’ordre de composition est translate, rotate, scale, puis transform.

La translation ne repositionne pas les éléments voisins dans la mise en page. Dans l’exemple, 50% de la largeur de 100px déplace l’élément de 50px vers la droite ; 10px le déplace vers le bas. Sa taille reste inchangée.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>translate</title>
<style>
  body { margin: 0; }
  #box {
    width: 100px;
    height: 60px;
    background: teal;
    translate: 50% 10px;
  }
</style>
<div id="box"></div>
<pre id="result"></pre>
<script>
  const rect = document.querySelector('#box').getBoundingClientRect();
  document.querySelector('#result').textContent =
    `x=${rect.x}, y=${rect.y}, width=${rect.width}, height=${rect.height}`;
</script>

Résultat

x=50, y=10, width=100, height=60

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources