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

CKTIS / CSS

scale3d(): escalas independentes para três eixos

Altera separadamente a escala de X, Y e Z sem recalcular as dimensões de disposição do elemento.

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

Sintaxe

transform: scale3d(2, 3, 4);

scale3d(sx, sy, sz) multiplica as coordenadas ao longo de três eixos. Os três argumentos separados por vírgulas são obrigatórios. Um fator de 1 deixa o respetivo eixo inalterado; um fator negativo reflete esse eixo. As percentagens representam fatores, pelo que 50% significa 0.5, e não metade das dimensões do elemento ascendente. Comprimentos como 2px não são fatores de escala.

O elemento continua a ser um plano, não um sólido com espessura. Escalar apenas Z não pode alargar nem aumentar a altura da sua superfície sem rotação situada em z=0. O fator Z é relevante para pontos deslocados em profundidade e para composições com rotações, translações ou perspetiva. transform-origin define o ponto de referência; a ordem das funções altera o resultado composto.

O exemplo transforma uma caixa de 40×30px com os fatores 2,3,4. O seu retângulo visível mede 80×90px, enquanto offsetWidth e offsetHeight se mantêm em 40×30. A matriz calculada transforma o ponto (1,2,5) em (2,6,20). A forma percentual produz os fatores diagonais 0.5,1,1.5 e a forma incompleta com dois argumentos é rejeitada.

Exemplos

const box=document.createElement('div');
box.style.cssText='position:fixed;left:60px;top:60px;width:40px;height:30px;transform-origin:0 0;transform:scale3d(2,3,4)';
document.body.append(box);
const rect=box.getBoundingClientRect();
const matrix=new DOMMatrix(getComputedStyle(box).transform);
const point=matrix.transformPoint(new DOMPoint(1,2,5));
box.style.transform='scale3d(50%,100%,150%)';
const percentages=new DOMMatrix(getComputedStyle(box).transform);
console.log('rendered='+rect.width+'x'+rect.height+'; layout='+box.offsetWidth+'x'+box.offsetHeight+'; point='+[point.x,point.y,point.z]+'; percentages='+[percentages.m11,percentages.m22,percentages.m33]+'; missing-z='+CSS.supports('transform','scale3d(2,3)'));

Resultado

rendered=80x90; layout=40x30; point=2,6,20; percentages=0.5,1,1.5; missing-z=false

As dimensões renderizadas e as dimensões de disposição respondem a perguntas diferentes. A terceira coordenada é verificada através da matriz calculada; o exemplo não pressupõe que a caixa tenha espessura física.

Fontes