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

CKTIS / CSS

mask-position — posicionar una imagen de máscara

La propiedad mask-position establece la posición de la imagen de cada capa de máscara. Admite palabras clave, longitudes y porcentajes; no desplaza el elemento ni modifica su diseño.

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

Sintaxis

mask-position: <position>#;

mask-position posiciona las imágenes de máscara con respecto al área definida por mask-origin. Su valor inicial es 0% 0% y no se hereda. La sintaxis <position># representa una lista de posiciones separadas por comas, asignadas a las capas sucesivas de mask-image.

Entre sus valores están center, left top, 20px 10px y right 20px bottom 10px. Con dos longitudes, la primera indica el desplazamiento horizontal y la segunda el vertical. Un único valor, como left, deja centrado el otro eje. Los porcentajes alinean puntos correspondientes de la imagen y del área de posicionamiento: 50% 50% centra la imagen. El desplazamiento en cada eje es (tamaño del área - tamaño de la imagen) × porcentaje; si ambos tamaños son iguales, los porcentajes no desplazan la imagen.

mask-size establece las dimensiones de la imagen, mientras que mask-repeat controla su repetición. En el ejemplo, no-repeat permite ver un único rectángulo de máscara. El enmascaramiento cambia la visibilidad, no las dimensiones de la caja de diseño. Cuando mask-image hace referencia a un elemento SVG mask, mask-position no tiene efecto en esa capa.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>mask-position</title>
<style>
  body { margin: 0; background: white; }
  .sample {
    width: 200px;
    height: 120px;
    background: #0066cc;
    mask-image: linear-gradient(black, black);
    mask-mode: alpha;
    mask-origin: border-box;
    mask-clip: border-box;
    mask-size: 80px 40px;
    mask-repeat: no-repeat;
    mask-position: right 20px bottom 10px;
  }
</style>
<div class="sample"></div>

Resultado

Expected visual geometry in CSS pixels: a blue 80 × 40 rectangle with its top-left corner at (100, 70), on a white page. The element retains its 200 × 120 layout box.

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