Propriedade mask-size

A propriedade mask-size define o tamanho da imagem de máscara. É possível definir tamanhos específicos em pixels/porcentagens ou usar as palavras-chave cover e contain.

Sintaxe

cssseletor {
  mask-size: auto | <length> | <percentage> | cover | contain;
}

Valores

Valor Descrição
auto Tamanho original da imagem (padrão).
cover Dimensiona a máscara mantendo as proporções para cobrir completamente o elemento.
contain Dimensiona a máscara mantendo as proporções para que ela caiba completamente dentro do elemento.
100px 50px Tamanhos específicos em pixels.
50% 100% Tamanhos em porcentagem das dimensões do elemento.

Exemplo . Tamanho cover

A máscara é dimensionada para cobrir completamente o elemento:

html<img id="image" src="image.jpg">
css#image {
  width: 500px;
  height: 281px;
  mask-image: url("heart.svg");
  mask-position: center;
  mask-size: cover;
  mask-repeat: no-repeat;
}

Результат:

Exemplo . Tamanho contain

A máscara é dimensionada para caber completamente dentro do elemento:

html<img id="image" src="image.jpg">
css#image {
  width: 500px;
  height: 281px;
  mask-image: url("heart.svg");
  mask-position: center;
  mask-size: contain;
  mask-repeat: no-repeat;
}

Результат:

Exemplo . Tamanho fixo em pixels

Máscara com tamanho de 150×150 pixels:

html<img id="image" src="image.jpg">
css#image {
  width: 500px;
  height: 281px;
  mask-image: url("heart.svg");
  mask-position: center;
  mask-size: 150px;
  mask-repeat: no-repeat;
}

Результат:

Exemplo . Tamanho em porcentagem

A máscara ocupa 80% da largura e 60% da altura do elemento:

html<img id="image" src="image.jpg">
css#image {
  width: 500px;
  height: 281px;
  mask-image: url("heart.svg");
  mask-position: center;
  mask-size: 80% 60%;
  mask-repeat: no-repeat;
}

Результат:

Exemplo . Tamanhos diferentes nos eixos

Máscara com 200px de largura e 100px de altura:

html<img id="image" src="image.jpg">
css#image {
  width: 500px;
  height: 281px;
  mask-image: url("heart.svg");
  mask-position: center;
  mask-size: 200px 100px;
  mask-repeat: no-repeat;
}

Результат:

Veja também

  • propriedade mask-position,
    define a posição da máscara
  • propriedade mask-repeat,
    define a repetição da máscara
  • propriedade mask,
    atalho para todas as propriedades de mascaramento