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

CKTIS / CSS

matrix() : une transformation affine en deux dimensions

Combinez échelle, cisaillement, rotation et translation dans six coefficients de matrice.

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

Syntaxe

transform: matrix(2, 0, 0, 3, 10, 20); transform-origin: 0 0;

matrix(a, b, c, d, e, f) représente une transformation affine en deux dimensions. En laissant provisoirement transform-origin de côté, un point devient x′ = a·x + c·y + e et y′ = b·x + d·y + f. Les quatre premiers coefficients décrivent la partie linéaire ; e et f sont des translations exprimées en nombres sans unité de pixels CSS. Leur ordre compte : échanger b et c change généralement la transformation.

La transformation agit autour de transform-origin : les mêmes nombres peuvent donc placer différemment une boîte si son origine change. Les transformations CSS modifient la géométrie visuelle sans réécrire la largeur ni la hauteur normales de mise en page. Un rectangle englobant transformé n’équivaut pas aux dimensions initiales de mise en page. L’ordre de composition importe aussi lorsque plusieurs transformations se combinent.

L’exemple utilise l’origine 0 0 et matrix(2, 0, 0, 3, 10, 20) sur une boîte de 40 sur 30 pixels. Le coin supérieur gauche est décalé de 10 et 20 pixels ; le rectangle rendu mesure 80 sur 90, tandis que la boîte de mise en page reste à 40 sur 30. Un cisaillement et une rotation nuls rendent ces mesures faciles à interpréter.

Exemples

const element=document.createElement('div');element.style.cssText='position:fixed;left:0;top:0;width:40px;height:30px;transform-origin:0 0;transform:matrix(2,0,0,3,10,20)';document.body.append(element);
const rect=element.getBoundingClientRect();
console.log('position='+rect.x+','+rect.y+'; rendered='+rect.width+'x'+rect.height+'; layout='+element.offsetWidth+'x'+element.offsetHeight+'; transform='+getComputedStyle(element).transform);

Résultat

position=10,20; rendered=80x90; layout=40x30; transform=matrix(2, 0, 0, 3, 10, 20)

Les dimensions rendues et celles de mise en page diffèrent volontairement ; la translation ne modifie pas une marge.

Sources