mask-border-width
=================

**Expérimental:** **Cette fonction est expérimentale**  
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.  
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La propriété CSS **`mask-border-width`** définit la largeur du masque de bordure d'un élément.

Syntaxe
-------


```css
/\* Valeur avec un mot-clé \*/
mask-border-width: auto;

/\* Valeur de longueur \*/
/\* Type <length> \*/
mask-border-width: 1rem;

/\* Valeur proportionnelle \*/
/\* Type <percentage> \*/
mask-border-width: 25%;

/\* Valeur numérique \*/
/\* Type <number> \*/
mask-border-width: 3;

/\* vertical | horizontal \*/
mask-border-width: 2em 3em;

/\* haut | horizontal | bas \*/
mask-border-width: 5% 15% 10%;

/\* haut | droit | bas | gauche \*/
mask-border-width: 5% 2em 10% auto;

/\* Valeurs globales \*/
mask-border-width: inherit;
mask-border-width: initial;
mask-border-width: unset;
```


La propriété `mask-border-width` peut être définie avec une, deux, trois ou quatre valeurs parmi celles de la liste ci-après.

* Lorsqu'une seule valeur est indiquée, elle est utilisée comme largeur pour les quatre côtés.
* Lorsque deux valeurs sont fournies, la première indique la largeur pour les côtés bas et haut et la deuxième la largeur pour les côtés gauche et droite.
* Lorsque trois valeurs sont fournies, la première est appliquée au côté haut, la deuxième au côté gauche et droit et la troisième au côté bas.
* Lorsque quatre valeurs sont fournies, elles s'appliquent respectivement aux côtés haut, droit, bas et gauche (c'est-à-dire dans l'ordre des aiguilles d'une montre).
### Valeurs

`<length-percentage>`

La largeur du masque de bordure, indiquée avec une valeur de type `<length>` ou `<percentage>`. Les pourcentages sont relatifs à la largeur de la zone de bordure pour les décalages horizontaux et à la hauteur de la zone de bordure pour les décalages verticaux. Cette valeur ne peut pas être négative.

`<number>`

La largeur du masque de bordure comme multiple de la largeur `border-width`. Cette valeur ne peut pas être négative.

`auto`

La largeur du masque de bordure est égale à la largeur ou à la hauteur intrinsèque de la valeur `mask-border-slice` correspondante. Si l'image ne possède pas de dimension intrinsèque, c'est la valeur `border-width` qui est utilisée à la place.

Définition formelle
-------------------

|  |  |
| --- | --- |
| Valeur initiale | `auto` |
| Applicabilité | tous les éléments ; en SVG, cela s'applique aux éléments conteneurs à l'exception des éléments `defs` et des éléments graphiques |
| Héritée | non |
| Pourcentages | relative to width/height of the mask border image area |
| Valeur calculée | comme spécifié, mais avec les longueurs relatives converties en longueurs absolues |
| Type d'animation | discrète |

Syntaxe formelle
----------------
```

mask-border-width =   
  [ <length-percentage> | <number> | auto ]{1,4}    
  
<length-percentage> =   
  <length>      |  
  <percentage>    
  
```

Spécifications
--------------

| Specification |
| --- |
| CSS Masking Module Level 1 # the-mask-border-width |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.