Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

mask-repeat — repetir una imagen de máscara

La propiedad mask-repeat controla si una imagen de máscara se repite y cómo lo hace en horizontal y vertical. Permite mostrar una sola máscara, crear mosaicos regulares o ajustar el espacio o el tamaño de los mosaicos.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

mask-repeat: <repeat-style>#;
<repeat-style> = repeat-x | repeat-y | [ repeat | space | round | no-repeat ]{1,2}

mask-repeat controla la repetición de las imágenes de máscara una vez establecidos su tamaño y su posición. Su valor inicial es repeat; no se hereda y su animación es discreta. mask-image proporciona la imagen, mask-size establece el tamaño del mosaico y mask-position su posición.

Un solo valor de entre repeat, space, round y no-repeat se aplica a ambos ejes. Con dos valores, el primero controla el eje horizontal y el segundo el vertical. repeat-x significa repeat no-repeat, y repeat-y significa no-repeat repeat. repeat repite los mosaicos, que pueden recortarse en los bordes; no-repeat muestra una sola copia en ese eje.

space coloca tantos mosaicos completos como sea posible sin escalarlos y distribuye entre ellos el espacio sobrante. Si caben al menos dos, los mosaicos de los extremos tocan los bordes del área de posicionamiento; si solo cabe uno, influye mask-position. round escala los mosaicos para que quepa un número entero de ellos.

Las comas separan los ajustes de las capas sucesivas de mask-image; si la lista es demasiado corta, se repite. La propiedad no tiene efecto en una capa que hace referencia a un elemento SVG mask. En el ejemplo, la mitad transparente de cada mosaico oculta el elemento y deja ver la página blanca.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>mask-repeat</title>
<style>
  body { background: white; }
  .sample {
    width: 160px;
    height: 80px;
    background: #0066cc;
    mask-image: linear-gradient(to right, black 50%, transparent 50%);
    mask-mode: alpha;
    mask-size: 40px 80px;
    mask-position: 0 0;
    mask-repeat: repeat-x;
  }
</style>
<div class="sample"></div>

Resultado

Four blue vertical stripes, each 20 CSS px wide and 80 CSS px high, separated by 20 CSS px transparent gaps showing the white page.

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.

Fuentes