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

CKTIS / CSS

mask-origin — zone de positionnement du masque

mask-origin choisit le rectangle de référence pour positionner une image de masque. Il ne définit pas la zone de découpage : cette fonction est assurée séparément par mask-clip.

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

Syntaxe

mask-origin: <coord-box>#;
<coord-box> = content-box | padding-box | border-box | fill-box | stroke-box | view-box

mask-origin définit la zone de positionnement du masque utilisée par mask-position. Sa valeur initiale est border-box ; la propriété n’est pas héritée et son animation est discrète.

content-box, padding-box et border-box sélectionnent les boîtes CSS correspondantes. En SVG, fill-box désigne la boîte englobante de l’objet, stroke-box inclut le contour et view-box sélectionne la fenêtre d’affichage SVG la plus proche, en tenant compte de viewBox. En l’absence de boîte de mise en page CSS, les trois premières valeurs sont calculées comme fill-box ; avec une telle boîte, les valeurs SVG sont calculées comme border-box.

Les valeurs séparées par des virgules correspondent aux couches successives de mask-image ; les listes plus courtes sont répétées. mask-clip limite la peinture indépendamment. mask-origin n’a aucun effet lorsque l’image du masque fait référence à un élément SVG mask.

L’exemple isole le positionnement : un masque opaque non répété révèle un carré au début de content-box, à 30 px du bord extérieur de la bordure.

Exemples

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

Résultat

A 40 × 40 CSS-pixel blue square on white, with its top-left corner 50 CSS pixels from the viewport's left and top edges.

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