CKTIS / CSS
translate3d(): três coordenadas com regras diferentes para a profundidade
Desloque ao longo de X, Y e Z, separando referências percentuais, projeção em perspetiva e disposição inalterada.
Versão: CSS Modules
Sintaxe
transform: perspective(240px) translate3d(0, 0, 60px);translate3d(tx, ty, tz) exige três componentes separados por vírgulas. X e Y aceitam comprimentos ou percentagens, calculados em relação à largura e altura da caixa de referência da transformação. Z aceita um comprimento, incluindo zero sem unidade, mas não uma percentagem, pois não existe uma referência percentual de profundidade correspondente. No sistema de coordenadas CSS habitual, Z positivo aponta para o observador.
Deslocar ao longo de Z não aumenta, por si só, uma caixa plana. A perspetiva fornece essa projeção e a ordem das funções de perspetiva e translação altera o resultado. Elementos aninhados que partilham uma cena 3D podem também exigir transform-style: preserve-3d. São controlos separados, não efeitos automáticos de translate3d(). Alterações no desenho não aumentam o espaço no fluxo normal nem garantem aceleração por hardware.
Para uma caixa de 80px por 40px, translate3d(50%,25%,60px) produz o vetor de matriz 40,10,60, enquanto a largura e altura sem projeção permanecem 80.00 por 40.00. Com perspective(240px) antes da translação de profundidade de 60px, os limites registados aumentam para 106.67 por 53.33; inverter as funções mantém-nos em 80.00 por 40.00. A disposição continua em 80px por 40px. O exemplo rejeita tanto a ausência do terceiro componente como um Z percentual; não desloca a caixa para o plano de observação da perspetiva nem para trás dele.
Exemplos
const box=document.createElement('div');box.style.cssText='position:fixed;left:100px;top:100px;width:80px;height:40px;transform-origin:0 0;transform-box:border-box';document.body.append(box);
box.style.transform='translate3d(50%,25%,60px)';
const m=new DOMMatrix(getComputedStyle(box).transform);const plain=box.getBoundingClientRect();
box.style.transform='perspective(240px) translate3d(0,0,60px)';const projected=box.getBoundingClientRect();
box.style.transform='translate3d(0,0,60px) perspective(240px)';const reversed=box.getBoundingClientRect();
console.log('vector='+[m.m41,m.m42,m.m43]+'; plain='+plain.width.toFixed(2)+'x'+plain.height.toFixed(2));
console.log('projected='+projected.width.toFixed(2)+'x'+projected.height.toFixed(2)+'; reversed='+reversed.width.toFixed(2)+'x'+reversed.height.toFixed(2)+'; layout='+box.offsetWidth+'x'+box.offsetHeight);
console.log('missing-z='+CSS.supports('transform','translate3d(1px,2px)')+'; percent-z='+CSS.supports('transform','translate3d(0,0,50%)'));
box.remove();Resultado
vector=40,10,60; plain=80.00x40.00 projected=106.67x53.33; reversed=80.00x40.00; layout=80x40 missing-z=false; percent-z=false
O exemplo usa uma origem de transformação zero e uma profundidade seguramente inferior à distância de perspetiva de 240px. As coordenadas da matriz são locais; os limites desenhados e as dimensões de disposição respondem a perguntas diferentes.