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

CKTIS / CSS

transform-origin — le pivot de transformation

transform-origin définit le point autour duquel un élément pivote ou change d’échelle. La propriété accepte des mots-clés, des longueurs et des pourcentages.

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

Syntaxe

transform-origin: [ left | center | right | top | bottom | <length-percentage> ] | [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ] <length>? | [ [ center | left | right ] && [ center | top | bottom ] ] <length>?;

transform-origin définit le pivot de la transformation ; à elle seule, cette propriété ne fait pas pivoter un élément. Sa valeur initiale est 50% 50% et elle n’est pas héritée.

Avec une seule valeur, l’autre coordonnée reste à center. Deux valeurs numériques indiquent X puis Y ; une troisième valeur facultative indique Z et doit être une longueur, pas un pourcentage. Si Z est omis, sa valeur est 0px. Les mots-clés left, center, right, top, bottom désignent les bords correspondants ou le centre ; les paires de mots-clés d’axes peuvent être inversées, par exemple top left.

Les pourcentages se rapportent à la boîte de référence choisie par transform-box, et non à l’élément parent. Le pivot peut se trouver en dehors de cette boîte. Pour les éléments SVG sans boîte de mise en page CSS associée, la valeur utilisée initiale est 0 0.

L’exemple fait pivoter un rectangle autour de son coin supérieur gauche. La transformation modifie le rendu, mais ne provoque pas une nouvelle mise en page du contenu environnant.

Exemples

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Transform origin</title>
<style>
  #frame {
    position: relative;
    margin: 48px;
    width: 80px;
    height: 40px;
    outline: 2px dashed #555;
  }
  #box {
    width: 100%;
    height: 100%;
    background: #1769aa;
    transform-box: border-box;
    transform-origin: left top;
    transform: rotate(90deg);
  }
</style>
</head>
<body>
<div id="frame" role="img" aria-label="Blue rectangle rotated 90 degrees clockwise about the upper-left corner of its original box, shown by a dashed outline.">
  <div id="box"></div>
</div>
<script>
  const frame = document.getElementById('frame').getBoundingClientRect();
  const box = document.getElementById('box');
  const rotated = box.getBoundingClientRect();
  const relativeX = x => Math.round(x - frame.left);
  const relativeY = y => Math.round(y - frame.top);
  console.log(`Computed transform-origin: ${getComputedStyle(box).transformOrigin}`);
  console.log(`Reference border box (outline excluded): x=0..${frame.width}, y=0..${frame.height}`);
  console.log(`Rotated border box relative to reference: x=${relativeX(rotated.left)}..${relativeX(rotated.right)}, y=${relativeY(rotated.top)}..${relativeY(rotated.bottom)}`);
</script>
</body>
</html>

Résultat

Computed transform-origin: 0px 0px
Reference border box (outline excluded): x=0..80, y=0..40
Rotated border box relative to reference: x=-40..0, y=0..80

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