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

CKTIS / CSS

transform-box — a caixa de referência da transformação

transform-box seleciona o retângulo de referência para as transformações e a respetiva origem. Influencia, entre outros aspetos, as translações percentuais e a interpretação de transform-origin em CSS e SVG.

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

Sintaxe

transform-box: content-box | border-box | fill-box | stroke-box | view-box;

transform-box seleciona a caixa de referência para transform e transform-origin; não aplica, por si só, uma transformação. As translações horizontais percentuais baseiam-se na sua largura e as verticais na sua altura. O valor inicial é view-box; a propriedade não é herdada, aplica-se a elementos transformáveis e é animada de forma discreta.

content-box designa a área do conteúdo. border-box inclui também o preenchimento e as bordas, mas não as margens exteriores. fill-box designa a caixa delimitadora do objeto, stroke-box tem em conta o traço e view-box utiliza a janela de visualização SVG mais próxima. Com viewBox, utiliza a origem do respetivo sistema de coordenadas e a largura e altura especificadas.

Para elementos com uma caixa de disposição CSS, fill-box funciona como content-box, enquanto stroke-box e view-box funcionam como border-box. Para elementos SVG sem uma caixa desse tipo, content-box funciona como fill-box e border-box como stroke-box.

No exemplo, translateX(100%) desloca as caixas 100px e 130px, respetivamente: o segundo cálculo inclui o preenchimento e as bordas dos dois lados.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>transform-box</title>
<style>
  .box {
    box-sizing: content-box;
    width: 100px;
    height: 20px;
    padding: 10px;
    border: 5px solid navy;
    margin: 10px 0;
    background: lightblue;
    transform: translateX(100%);
  }
  .content { transform-box: content-box; }
  .border { transform-box: border-box; }
</style>
<div class="box content">content-box</div>
<div class="box border">border-box</div>

Resultado

content-box: translateX = 100px
border-box: translateX = 130px

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes