Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

matrix(): uma transformação afim bidimensional

Combine escala, inclinação, rotação e translação em seis coeficientes de matriz.

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

Sintaxe

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

matrix(a, b, c, d, e, f) representa uma transformação afim bidimensional. Ignorando por agora transform-origin, um ponto passa a x′ = a·x + c·y + e e y′ = b·x + d·y + f. Os primeiros quatro coeficientes descrevem a parte linear; e e f são translações expressas como números sem unidade em píxeis CSS. As posições importam: trocar b e c geralmente altera a transformação.

A transformação atua em torno de transform-origin, pelo que os mesmos seis números podem posicionar a caixa de outra forma se a origem mudar. As transformações CSS afetam a geometria visual sem reescrever a largura e a altura normais da disposição. Um retângulo delimitador transformado não equivale às dimensões de disposição originais. A combinação de várias transformações também depende da sua ordem.

O exemplo utiliza a origem 0 0 e matrix(2, 0, 0, 3, 10, 20) numa caixa de 40 por 30 píxeis. Desloca o canto superior esquerdo 10 e 20 píxeis e produz um retângulo renderizado de 80 por 90, mantendo a caixa de disposição em 40 por 30. Deixar inclinação e rotação a zero facilita a interpretação das medidas.

Exemplos

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

Resultado

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

As dimensões renderizadas e de disposição diferem intencionalmente; a translação não altera uma margem.

Fontes