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

CKTIS / CSS

rotateX(): inclinar em torno do eixo horizontal

Mova pontos entre y e z mantendo x e a altura original no layout.

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

Sintaxe

transform: rotateX(60deg);

A função rotateX() roda em torno de x e equivale a rotate3d(1, 0, 0, angle). Aceita um ângulo ou zero sem unidade. Com a origem em zero, x permanece inalterado enquanto a rotação combina y e z. Na convenção CSS habitual, z positivo aponta para o observador: um quarto de volta positivo leva um ponto de y positivo para z positivo.

O centro predefinido e um transform-origin escolhido podem dar posições diferentes com o mesmo ângulo. A perspetiva é opcional e afeta a projeção da profundidade. backface-visibility controla separadamente a face posterior; não define a rotação nem garante a sua acessibilidade. Interfaces com muito movimento devem respeitar a preferência por movimento reduzido; conteúdo importante não deve depender apenas de uma face inclinada ou escondida.

O exemplo fixa a origem em zero e não usa perspetiva. Uma rotação positiva de 90 graus transforma 5,10,0 em 5,0,10; a negativa dá 5,0,-10. A função axial equivalente produz o mesmo resultado positivo. A 60 graus, a altura de layout continua a ser 80px, mas os limites projetados têm 40px. A 90 graus, a altura medida é zero porque a caixa plana é vista de lado, pela aresta. Isto não promete que qualquer objeto aninhado, composto em volume ou transformado em perspetiva se torne invisível.

Exemplos

const box = document.createElement('div');
box.style.cssText = 'width:100px;height:80px;transform-origin:0 0';
document.body.append(box);
function point(transform) {
  box.style.transform = transform;
  const p = new DOMMatrix(getComputedStyle(box).transform).transformPoint(new DOMPoint(5,10,0));
  return [p.x,p.y,p.z].map(n => Number(n.toFixed(6))).join(',');
}
console.log('+90:', point('rotateX(90deg)'));
console.log('-90:', point('rotateX(-90deg)'));
console.log('axis equivalent:', point('rotate3d(1,0,0,90deg)'));
box.style.transform = 'rotateX(60deg)';
console.log('layout height:', box.offsetHeight);
console.log('projected height:', Number(box.getBoundingClientRect().height.toFixed(6)));
box.style.transform = 'rotateX(90deg)';
console.log('edge-on height:', Number(box.getBoundingClientRect().height.toFixed(6)));
box.remove();

Resultado

+90: 5,0,10
-90: 5,0,-10
axis equivalent: 5,0,10
layout height: 80
projected height: 40
edge-on height: 0

As medições dizem respeito a um retângulo plano sem perspetiva. Verificam coordenadas e limites, não a pintura da face posterior, leitores de ecrã ou uma interface animada completa.

Fontes