Mask-border-source - Propriété CSS

mask-border-source
mask-border

Résumé des caractéristiques de la propriété mask-border-source

Description rapide
Désigne l'image qui sera utilisée comme masque (masque du type bordure).
Statut
Problèmes de compatibilité
S'applique à
HTML : tous les éléments.
SVG : conteneurs sauf defs, éléments graphiques, use.
Utilisable sur
HTML, SVG
Pourcentages
Ne s'appliquent pas.
Valeur initiale
none
Héritée par défaut
Non.
Discrète : lors d'une animation, la propriété mask-border-source passe d'une valeur à l'autre sans transition.
Module W3C
Module CSS - Masquage
Statut du document: CR (document candidat à la recommandation)

Schéma de la syntaxe de mask-border-source.

mask-border-source - Syntax DiagramSyntax diagram of the mask-border-source CSS property. none none url( ... ) url( ... )mask-border-source:;mask-border-source:;
Schéma syntaxique de la propriété mask-border-source.
Cliquez sur les liens du schéma pour plus de précisons sur les valeurs.

Description de la propriété mask-border-source.

La propriété mask-border-source est encore mal reconnues par les navigateurs. Sur les navigateurs basés sur webkit, il y a une propriété équivalente préfixée par -webkit-. Il s'agit de -webkit-mask-box-source. Sur Firefox   il n'y a pas d'équivalence.

Le masquage des bordures consiste à masquer le pourtour de l'image suivant un masque. Ce masque est divisé en 9 parties qui s'agrandissent ou se répètent différemment les unes des autres. Voir mask-border pour davantage de précision.

mask-border-source définit quel est le masque à utiliser. Si l'image est absente ou est dans un format non reconnu, le masque ne s'applique pas.

Si un masque est également appliqué à l'élément (voir à ce sujet la propriété mask), les deux masques sont appliqués dans un ordre quelconque, le résultat étant identique quelque soit l'ordre.


Voici les propriétés qui jouent un rôle dans les masques de bordure :

Propriété résumée. Définit tous les paramètres d'un masque pour la bordure d'un élément.
Désigne l'image qui sera utilisée comme masque (masque du type bordure).
Définit comment l'image utilisée comme masque doit être découpée.
Définit l'épaisseur de la bordure pour l'application d'un masque.
Définit le décalage éventuel du masque de bordure par rapport à l'élément.
Définit le mode de répétition du masque.
Définit sur quel paramètre le masque doit agir (luminance, alpha).

Valeurs pour mask-border-source.

  • mask-border-source: none;

    Aucun masque de bordure n'est appliqué.

  • mask-border-source: url(...)

    Avec cette syntaxe mask-border-source définit quelle image sera utilisée en tant que masque. Pour que le résultat soit conforme aux attentes, il sera nécessaire de définit également la propriété mask-border-slice.

    Rappelons que l'image choisie sera divisée en 9 parties : une pour chacun des quatre angles, une pour chacun des quatre bords et une pour la partie centrale de l'élément, conformément au dessin ci-dessous.

    Découpage de l'image de masque

  • mask-border-source: initial; (none) mask-border-source: inherit; mask-border-source: revert; mask-border-source: revertLayer; mask-border-source: unset;

    Consultez les pages suivantes pour plus de détails : initial, inherit, revert, revert-layer, unset.

Exemple d'animation de mask-border-source.

La propriété mask-border-source peut être animée, de façon discrète, c'est à dire avec passage brutal d'une valeur à l'autre. Néanmoins certains navigateurs comme Edge  , Chrome  , etc. enchaîne les images avec un fondu. L'exemple alterne les deux masques ci-dessous.

L'animation ne fonctionne pas sous Firefox  , et pour les autres navigateurs, nous avons utilisé la propriété non standard -webkit-mask-box-image-source.

Premier masque
Deuxième masque
Image découpée avec un masque

Compatibilité des navigateurs avec mask-border-source.

Les navigateurs ne traitent pas encore suffisamment la technique de masquage par bordure (2025). Firefox   en particulier ne reconnaît aucune des propriétés. Sur les autres navigateurs, vous pouvez utiliser provisoire la propriété -webkit-mask-box-image-slice en remplacement de mask-border-source.

Colonne 1
Prise en charge par les navigateurs de la propriété mask-border-source qui définit quel masque utiliser pour les bordures.

Remarques :

(1) La propriété n'est pas encore reconnue : utilisez -webkit-mask-box-image-source à la place.

1
Propriété
mask-border-source
Estimation de la prise en charge globale.
13%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

UC Browser pour Androïd

Opéra Mobile

QQ Browser

Baidu Browser

Safari

Safari sur IOS

Samsung Internet

Firefox

Androïd Brower

Firefox pour Androïd

Chrome pour Androïd

Chrome

Edge

Opéra

KaiOS Browser

Opéra mini

Histoire de la propriété mask-border-source.

  • Module CSS - Masquage - Niveau 1

    Introduction de la propriété mask-border-source ainsi que des autres propriété relatives au masquage des bordures.
    WD
    15 Novembre 2012
    Document de travail.
    CR
    26 Août 2014
    Candidat à la recommandation.
    PR
    REC

Voir aussi, au sujet des techniques de masquage.

Les propriétés relatives au masque de bordures sont publiés dans {CSS Masking Module, tout comme les propriétés relatives au masquage classique des éléments.

Propriétés :

clip
Découpe un élément à partir d'un rectangle.
clip-path
Définit la partie visible de l'élément, délimitée par une forme géométrique (rectangle, polygone...).
clip-rule
Définit comment gérer les formes creuses dans le contexte d'un découpage.
mask
Propriété résumée définissant les paramètres de masquage : dimensions du masque, position, répétition, origine, etc.
mask-border
Propriété résumée. Définit tous les paramètres d'un masque pour la bordure d'un élément.
mask-border-mode
Définit sur quel paramètre le masque doit agir (luminance, alpha).
mask-border-outset
Définit le décalage éventuel du masque de bordure par rapport à l'élément.
mask-border-repeat
Définit le mode de répétition du masque.
mask-border-slice
Définit comment l'image utilisée comme masque doit être découpée.
mask-border-width
Définit l'épaisseur de la bordure pour l'application d'un masque.
mask-clip
Définit la zone concernée par le masquage.
mask-composite
Définit comment seront combinés les masques lorsque plusieurs sont appliqués sur un élément.
mask-image
Désigne l'image ou le fichier SVG qui sera utilisé comme masque.
mask-mode
Définit le mode de masquage (couche alpha, luminance...)
mask-origin
Définit la référence pour le positionnement du masque.
mask-position
Définit la position du masque.
mask-repeat
Définit le mode de répétition du masque lorsque celui-ci est plus petit que l'élément à masquer.
mask-size
Fixe les dimensions du masque.
mask-type
Définit quel paramètre du masque est utilisé pour masquer l'élément.