Propiedad mask-size

La propiedad mask-size establece el tamaño de la imagen de máscara. Se pueden especificar dimensiones concretas en píxeles/porcentajes o usar las palabras clave cover y contain.

Sintaxis

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

Valores

Valor Descripción
auto Tamaño original de la imagen (por defecto).
cover Escala la máscara manteniendo las proporciones para que cubra completamente el elemento.
contain Escala la máscara manteniendo las proporciones para que quepa completamente dentro del elemento.
100px 50px Dimensiones concretas en píxeles.
50% 100% Dimensiones en porcentaje de las dimensiones del elemento.

Ejemplo . Tamaño cover

La máscara se escala para cubrir completamente el 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;
}

Результат:

Ejemplo . Tamaño contain

La máscara se escala para caber completamente dentro del 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;
}

Результат:

Ejemplo . Tamaño fijo en píxeles

Máscara de 150×150 píxeles:

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;
}

Результат:

Ejemplo . Tamaño en porcentaje

La máscara ocupa el 80% del ancho y el 60% del alto del 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;
}

Результат:

Ejemplo . Diferentes tamaños en ejes

Máscara de 200px de ancho y 100px de alto:

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;
}

Результат:

Véase también

  • propiedad mask-position,
    define la posición de la máscara
  • propiedad mask-repeat,
    define la repetición de la máscara
  • propiedad mask,
    abreviatura para todas las propiedades de enmascaramiento