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

CKTIS / CSS

mask-origin — área de posicionamento da máscara

mask-origin seleciona o retângulo de referência para posicionar uma imagem de máscara. Não seleciona a área de recorte: essa função é controlada separadamente por mask-clip.

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

Sintaxe

mask-origin: <coord-box>#;
<coord-box> = content-box | padding-box | border-box | fill-box | stroke-box | view-box

mask-origin define a área de posicionamento da máscara utilizada por mask-position. O valor inicial é border-box; a propriedade não é herdada e a sua animação é discreta.

content-box, padding-box e border-box selecionam as caixas CSS correspondentes. Em SVG, fill-box designa a caixa delimitadora do objeto, stroke-box inclui o traço e view-box seleciona a janela de visualização SVG mais próxima, tendo em conta viewBox. Sem uma caixa de disposição CSS, os três primeiros valores são calculados como fill-box; com essa caixa, os valores SVG são calculados como border-box.

Os valores separados por vírgulas correspondem às camadas sucessivas de mask-image; as listas mais curtas são repetidas. mask-clip restringe a pintura de forma independente. mask-origin não tem efeito quando a imagem de máscara faz referência a um elemento SVG mask.

O exemplo isola o posicionamento: uma máscara opaca sem repetição revela um quadrado no início de content-box, a 30 px da extremidade exterior do contorno.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>mask-origin</title>
<style>
  body { margin: 20px; background: white; }
  .sample {
    box-sizing: content-box;
    width: 120px;
    height: 80px;
    padding: 20px;
    border: 10px solid #0066cc;
    background: #0066cc;
    mask-image: linear-gradient(black, black);
    mask-mode: alpha;
    mask-size: 40px 40px;
    mask-repeat: no-repeat;
    mask-position: 0 0;
    mask-origin: content-box;
    mask-clip: border-box;
  }
</style>
<div class="sample"></div>

Resultado

A 40 × 40 CSS-pixel blue square on white, with its top-left corner 50 CSS pixels from the viewport's left and top edges.

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