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-boxmask-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.