Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

mask-repeat — répéter une image de masque

La propriété mask-repeat définit si et comment une image de masque se répète horizontalement et verticalement. Elle permet d’afficher un masque unique, de créer des motifs réguliers ou d’ajuster l’espacement ou la taille des motifs.

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

Syntaxe

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

mask-repeat contrôle la répétition des images de masque une fois leur taille et leur position définies. Sa valeur initiale est repeat ; elle n’est pas héritée et son animation est discrète. mask-image fournit l’image, mask-size définit la taille du motif et mask-position sa position.

Une seule valeur parmi repeat, space, round et no-repeat s’applique aux deux axes. Avec deux valeurs, la première contrôle l’axe horizontal et la seconde l’axe vertical. repeat-x signifie repeat no-repeat, et repeat-y signifie no-repeat repeat. repeat répète les motifs, qui peuvent être coupés aux bords ; no-repeat affiche une seule copie sur l’axe concerné.

space place autant de motifs entiers que possible, sans les redimensionner, et répartit l’espace restant entre eux. Si au moins deux motifs tiennent, ceux des extrémités touchent les bords de la zone de positionnement ; si un seul tient, mask-position intervient. round redimensionne les motifs pour qu’un nombre entier d’entre eux tienne.

Les virgules séparent les réglages des couches mask-image successives ; une liste trop courte est répétée. La propriété n’a aucun effet sur une couche qui fait référence à un élément SVG mask. Dans l’exemple, la moitié transparente de chaque motif masque l’élément et laisse apparaître la page blanche.

Exemples

<!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>

Résultat

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.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources