CKTIS / CSS
mask-size — tamaño de las imágenes de máscara
La propiedad mask-size establece las dimensiones de las imágenes de las capas de máscara, no las del elemento. Acepta longitudes, porcentajes, auto, contain y cover; se pueden definir tamaños distintos para varias capas.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;mask-size escala las imágenes proporcionadas por mask-image sin cambiar las dimensiones del elemento en el diseño de la página. Su valor inicial es auto y no se hereda. Por sí sola no crea una máscara.
Una longitud o un porcentaje especifica el ancho, y la altura pasa a ser auto; dos valores especifican el ancho y la altura, respectivamente. Los valores negativos no son válidos. Los porcentajes se refieren a las dimensiones correspondientes del área de posicionamiento de la máscara, determinada por mask-origin, no a las dimensiones del archivo de imagen.
auto utiliza las dimensiones naturales y la proporción de la imagen cuando están disponibles. Con auto auto, un degradado sin dimensiones naturales llena el área de posicionamiento. contain conserva la proporción y ajusta toda la imagen dentro de esa área; cover conserva la proporción y cubre toda el área, por lo que una parte de la imagen puede sobresalir. Dos dimensiones explícitas pueden distorsionar la proporción.
Los tamaños de varias capas se separan con comas y siguen el orden de mask-image. Si la lista es demasiado corta, se repite; los valores sobrantes se ignoran. mask-repeat controla por separado la repetición de la imagen. Excepción importante: si la fuente es un elemento SVG mask, mask-size no afecta a esa capa; el propio elemento define su geometría.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>mask-size</title>
<style>
body { margin: 20px; background: white; }
.sample {
width: 240px;
height: 120px;
background: #0066cc;
mask-image: linear-gradient(black, black);
mask-mode: alpha;
mask-origin: border-box;
mask-size: 50% 100%;
mask-position: center;
mask-repeat: no-repeat;
}
</style>
<div class="sample"></div>Resultado
A 120 × 120 CSS-pixel blue square is visible, centered horizontally within a 240 × 120 CSS-pixel element; the remaining area shows the white page background.
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.