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

CKTIS / CSS

mask-type — interpréter un masque SVG

mask-type détermine comment le contenu d’un masque SVG est interprété : luminance tient compte de la luminance et de la transparence, tandis que alpha ne tient compte que de la transparence.

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

Syntaxe

mask-type: luminance | alpha;

mask-type s’applique aux éléments SVG mask, et non à l’élément masqué. Sa valeur initiale est luminance ; la propriété n’est pas héritée et son animation est discrète.

luminance multiplie la luminance par l’alpha : le noir opaque masque et le blanc révèle. alpha ignore la couleur : le noir et le blanc opaques révèlent de la même façon. Les zones transparentes masquent dans les deux modes.

Avec mask-mode: match-source sur l’élément masqué, c’est le mask-type du masque référencé qui s’applique. Un mask-mode: alpha ou mask-mode: luminance explicite remplace ce choix. match-source n’est pas une valeur de mask-type. Définir mask-type seul n’assigne pas de masque ; l’exemple utilise mask avec une référence url(...).

Exemples

<!doctype html>
<meta charset="utf-8">
<title>mask-type</title>
<style>
  #luma { mask-type: luminance; }
  #alpha { mask-type: alpha; }
  .target { mask-mode: match-source; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="220" height="70" viewBox="0 0 220 70">
  <defs>
    <mask id="luma" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="60">
      <rect width="50" height="60" fill="black"/>
      <rect x="50" width="50" height="60" fill="white"/>
    </mask>
    <mask id="alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="60">
      <rect width="50" height="60" fill="black"/>
      <rect x="50" width="50" height="60" fill="white"/>
    </mask>
  </defs>
  <rect width="220" height="70" fill="white"/>
  <rect class="target" width="100" height="60" fill="blue" mask="url(#luma)"/>
  <g transform="translate(120 0)">
    <rect class="target" width="100" height="60" fill="blue" mask="url(#alpha)"/>
  </g>
</svg>

Résultat

Expected: on white, the left target shows only its right blue half; the right target is entirely blue.

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