Propriedade mask-clip

A propriedade mask-clip define a área do elemento dentro da qual a máscara será exibida. Ela determina quais partes do elemento serão afetadas pela máscara e quais permanecerão visíveis sem alterações.

Sintaxe

cssseletor {
  mask-clip: valor | no-clip;
}

Valores

Valor Descrição
border-box A máscara é aplicada à área, incluindo as bordas do elemento.
padding-box A máscara é aplicada à área, incluindo o preenchimento (padding), mas não as bordas.
content-box A máscara é aplicada apenas ao conteúdo do elemento.
margin-box A máscara é aplicada à área, incluindo a margem (experimental).
fill-box A máscara é aplicada à caixa delimitadora do objeto (para SVG).
stroke-box A máscara é aplicada à caixa delimitadora do traço (stroke bounding box) (para SVG).
view-box A máscara é aplicada à viewbox (para SVG).
no-clip A máscara não é limitada à área do elemento.

Valor padrão: border-box.

Exemplo . Aplicando mask-clip a diferentes áreas

Vamos comparar diferentes valores de mask-clip em um elemento com bordas e preenchimento:

html<div class="box border-box">border-box</div>
<div class="box padding-box">padding-box</div>
<div class="box content-box">content-box</div>
css.box {
  width: 200px;
  height: 100px;
  margin: 20px;
  padding: 20px;
  border: 10px dashed black;
  background: linear-gradient(45deg, red, blue);
  mask-image: linear-gradient(to right, black, transparent);
  mask-size: 100% 100%;
  mask-repeat: no-repeat;
  display: inline-block;
}

.border-box {
  mask-clip: border-box;
}

.padding-box {
  mask-clip: padding-box;
}

.content-box {
  mask-clip: content-box;
}

Результат:

Exemplo . Usando no-clip

Demonstração do valor no-clip, onde a máscara se estende além dos limites do elemento:

html<div id="elem"></div>
css#elem {
  width: 200px;
  height: 200px;
  background: linear-gradient(45deg, red, blue);
  mask-image: radial-gradient(circle, black 50%, transparent 70%);
  mask-size: 300px 300px;
  mask-position: center;
  mask-clip: no-clip;
  border: 2px solid black;
}

Результат:

Exemplo . SVG com diferentes valores de mask-clip

Aplicando vários valores a um elemento SVG:

html<svg width="400" height="200">
  <defs>
    <mask id="mask1" maskContentUnits="objectBoundingBox">
      <rect x="0.1" y="0.1" width="0.8" height="0.8" fill="white"/>
    </mask>
  </defs>
  
  <rect x="10" y="10" width="180" height="180" fill="blue" 
    mask="url(#mask1)" mask-clip="fill-box"/>
    
  <rect x="210" y="10" width="180" height="180" fill="red" 
    mask="url(#mask1)" mask-clip="view-box"/>
</svg>

Результат:

Veja também

  • propriedade mask-origin,
    define a posição de origem da máscara
  • propriedade mask-image,
    define a imagem para a máscara
  • propriedade mask,
    atalho para todas as propriedades de mascaramento
  • propriedade clip-path,
    cria uma área de recorte para o elemento