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

CKTIS / CSS

rotate(): uma rotação bidimensional em que a ordem importa

Rode em torno da origem escolhida sem confundir os limites visuais com as dimensões do layout.

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

Sintaxe

transform: rotate(90deg);

A função de transformação rotate() aceita um ângulo ou zero sem unidade e roda em torno de transform-origin. Nas coordenadas de ecrã CSS habituais, x cresce para a direita e y para baixo; por isso, um quarto de volta positivo leva um ponto do eixo x positivo para o eixo y positivo. O exemplo verifica ambas as direções do texto. Não confunda esta função dentro de transform com a propriedade independente rotate nem com a antiga sintaxe de atributo SVG de três argumentos.

A ordem importa: a matriz da função escrita mais à direita atua primeiro num ponto local. Uma rotação escrita antes de uma translação difere, portanto, da ordem inversa. A origem também influencia a posição final. Ler apenas a matriz calculada não inclui as translações adicionais em torno da origem especificada separadamente; o exemplo fixa-a em zero e interpreta assim a medição.

No Chromium 157, uma rotação positiva de 90 graus transforma o ponto em 0,10 tanto para ltr como para rtl; a negativa dá 0,-10. Trocar as duas funções altera a origem transformada de 0,10 para 10,0. A caixa final mantém as dimensões de layout de 80 por 40, mas os seus limites visuais alinhados com os eixos passam a 40 por 80. A transformação altera o desenho e pode afetar o transbordo, sem reorganizar o fluxo normal vizinho para acomodar o retângulo rodado.

Exemplos

const box = document.createElement('div');
box.style.cssText = 'width:80px;height:40px;transform-origin:0 0';
document.body.append(box);
function point(transform, x, y) {
  box.style.transform = transform;
  const p = new DOMMatrix(getComputedStyle(box).transform).transformPoint(new DOMPoint(x,y));
  return [p.x,p.y].map(n => Number(n.toFixed(6))).join(',');
}
for (const direction of ['ltr','rtl']) {
  box.style.direction = direction;
  console.log(direction + ' +90:', point('rotate(90deg)',10,0));
}
console.log('-90:', point('rotate(-90deg)',10,0));
console.log('rotate then translate list:', point('rotate(90deg) translateX(10px)',0,0));
console.log('translate then rotate list:', point('translateX(10px) rotate(90deg)',0,0));
box.style.transform = 'rotate(90deg)';
console.log('layout:', box.offsetWidth, box.offsetHeight);
const bounds = box.getBoundingClientRect();
console.log('visual bounds:', Math.round(bounds.width), Math.round(bounds.height));
box.remove();

Resultado

ltr +90: 0,10
rtl +90: 0,10
-90: 0,-10
rotate then translate list: 0,10
translate then rotate list: 10,0
layout: 80 40
visual bounds: 40 80

As coordenadas provêm da matriz calculada e são arredondadas a seis casas decimais. Os limites são medidos à parte; não se usam animações nem avaliações do sentido a partir de capturas de ecrã.

Fontes