CKTIS / CSS
mask-position — posicionar uma imagem de máscara
A propriedade mask-position define a posição da imagem de cada camada de máscara. Aceita palavras-chave, comprimentos e percentagens; não desloca o próprio elemento nem altera a sua disposição.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
mask-position: <position>#;mask-position posiciona as imagens de máscara relativamente à área definida por mask-origin. O valor inicial é 0% 0% e a propriedade não é herdada. A sintaxe <position># representa uma lista de posições separadas por vírgulas, atribuídas às camadas sucessivas de mask-image.
Os valores incluem center, left top, 20px 10px e right 20px bottom 10px. Com dois comprimentos, o primeiro indica o deslocamento horizontal e o segundo o vertical. Um único valor, como left, deixa o outro eixo centrado. As percentagens alinham pontos correspondentes da imagem e da área de posicionamento: 50% 50% centra a imagem. O deslocamento em cada eixo é (tamanho da área - tamanho da imagem) × percentagem; se os tamanhos forem iguais, as percentagens não causam deslocamento.
mask-size define as dimensões da imagem, enquanto mask-repeat controla a repetição. No exemplo, no-repeat permite ver um único retângulo de máscara. A máscara altera a visibilidade, não as dimensões da caixa de disposição. Quando mask-image referencia um elemento SVG mask, mask-position não tem efeito nessa camada.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>mask-position</title>
<style>
body { margin: 0; background: white; }
.sample {
width: 200px;
height: 120px;
background: #0066cc;
mask-image: linear-gradient(black, black);
mask-mode: alpha;
mask-origin: border-box;
mask-clip: border-box;
mask-size: 80px 40px;
mask-repeat: no-repeat;
mask-position: right 20px bottom 10px;
}
</style>
<div class="sample"></div>Resultado
Expected visual geometry in CSS pixels: a blue 80 × 40 rectangle with its top-left corner at (100, 70), on a white page. The element retains its 200 × 120 layout box.
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.