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

CKTIS / CSS

mask-size — dimensionner les images de masque

La propriété mask-size définit les dimensions des images des couches de masque, et non celles de l’élément lui-même. Elle accepte des longueurs, des pourcentages, auto, contain et cover ; plusieurs couches peuvent avoir des tailles différentes.

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

Syntaxe

mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;

mask-size met à l’échelle les images fournies par mask-image sans modifier les dimensions de mise en page de l’élément. Sa valeur initiale est auto et elle n’est pas héritée. À elle seule, elle ne crée pas de masque.

Une longueur ou un pourcentage définit la largeur, tandis que la hauteur vaut auto par défaut ; deux valeurs définissent respectivement la largeur et la hauteur. Les valeurs négatives ne sont pas valides. Les pourcentages se rapportent aux dimensions correspondantes de la zone de positionnement du masque, déterminée par mask-origin, et non aux dimensions du fichier image.

auto utilise les dimensions naturelles et les proportions de l’image lorsqu’elles sont disponibles. Avec auto auto, un dégradé sans dimensions naturelles remplit la zone de positionnement. contain conserve les proportions et fait tenir toute l’image dans cette zone ; cover conserve les proportions et couvre toute la zone, de sorte qu’une partie de l’image peut en dépasser. Deux dimensions explicites peuvent déformer les proportions.

Les tailles de plusieurs couches sont séparées par des virgules, dans l’ordre de mask-image. Une liste trop courte est répétée ; les valeurs en trop sont ignorées. mask-repeat contrôle séparément la répétition de l’image. Exception importante : si la source est un élément SVG mask, mask-size n’a aucun effet sur cette couche ; la géométrie est définie par cet élément.

Exemples

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

Résultat

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.

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