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

CKTIS / CSS

mask-type — interpretação de uma máscara SVG

mask-type determina como é interpretado o conteúdo de uma máscara SVG: luminance tem em conta a luminância e a transparência, enquanto alpha considera apenas a transparência.

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

Sintaxe

mask-type: luminance | alpha;

mask-type aplica-se a elementos SVG mask, não ao elemento mascarado. O valor inicial é luminance; a propriedade não é herdada e a animação é discreta.

luminance multiplica a luminância pelo alfa: o preto opaco oculta e o branco revela. alpha ignora a cor: o preto e o branco opacos revelam da mesma forma. As áreas transparentes ocultam em ambos os modos.

Com mask-mode: match-source no elemento mascarado, aplica-se o mask-type da máscara referenciada. Um mask-mode: alpha ou mask-mode: luminance explícito substitui essa escolha. match-source não é um valor de mask-type. Definir apenas mask-type não atribui uma máscara; o exemplo utiliza mask com uma referência url(...).

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>mask-type</title>
<style>
  #luma { mask-type: luminance; }
  #alpha { mask-type: alpha; }
  .target { mask-mode: match-source; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="220" height="70" viewBox="0 0 220 70">
  <defs>
    <mask id="luma" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="60">
      <rect width="50" height="60" fill="black"/>
      <rect x="50" width="50" height="60" fill="white"/>
    </mask>
    <mask id="alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="60">
      <rect width="50" height="60" fill="black"/>
      <rect x="50" width="50" height="60" fill="white"/>
    </mask>
  </defs>
  <rect width="220" height="70" fill="white"/>
  <rect class="target" width="100" height="60" fill="blue" mask="url(#luma)"/>
  <g transform="translate(120 0)">
    <rect class="target" width="100" height="60" fill="blue" mask="url(#alpha)"/>
  </g>
</svg>

Resultado

Expected: on white, the left target shows only its right blue half; the right target is entirely blue.

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